通过MCP集成Claude Desktop API

本项目提供了一个MCP服务器实现，使Claude Desktop与Claude API之间能够无缝集成。它允许您绕过专业计划的限制，并访问高级功能，如自定义系统提示和对话管理。

功能

• 通过MCP直接集成Claude API
• 对话历史记录跟踪和管理
• 系统提示支持
• 在专业计划和API使用之间无缝切换
• 使用Claude Desktop进行简单配置

使用场景

• 专业计划（默认）：

  • 在Claude Desktop中进行常规对话
  • 在计划限制内进行基本使用
  • 不需要特殊配置

• API令牌（通过此MCP服务器）：

  • 当您需要更长的上下文窗口时
  • 使用自定义系统提示
  • 绕过速率限制
  • 进行高级对话管理

安装指南

1. 克隆仓库

   # 使用VS Code：
   # 1. 按Cmd + Shift + P
   # 2. 输入“Git: Clone”
   # 3. 粘贴：https://github.com/mlobo2012/Claude_Desktop_API_USE_VIA_MCP.git
   
   # 或者使用终端：
   git clone https://github.com/mlobo2012/Claude_Desktop_API_USE_VIA_MCP.git
   cd Claude_Desktop_API_USE_VIA_MCP
   

2. 安装依赖项

   pip install -r requirements.txt
   

3. 配置环境

   # 复制环境模板
   cp .env.example .env
   
   # 编辑.env并添加您的API密钥
   ANTHROPIC_API_KEY=your_api_key_here
   

4. 配置Claude Desktop

   • macOS：导航到~/Library/Application Support/Claude/

     # 使用Finder：
     # 1. 按Cmd + Shift + G
     # 2. 输入：~/Library/Application Support/Claude/
     

   • Windows：导航到%APPDATA%\Claude\
   • 创建或编辑claude_desktop_config.json
   • 从config/claude_desktop_config.json复制内容
   • 更新路径和API密钥

使用指南

基础用法

1. 常规Claude Desktop使用

   • 只需正常与Claude聊天
   • 使用您的专业计划
   • 不需要特殊命令

2. API使用

   @claude-api 请使用API回答：法国的首都是哪里？
   

高级功能

1. 使用系统提示

   @claude-api {"system_prompt": "您是一位健身教练专家"} 制定一个锻炼计划
   

2. 管理对话

   # 开始新对话
   @claude-api {"conversation_id": "project1"} 让我们讨论Python
   
   # 继续同一对话
   @claude-api {"conversation_id": "project1"} 再告诉我一些
   
   # 查看对话历史
   @claude-api get_conversation_history project1
   
   # 清除对话
   @claude-api clear_conversation project1
   

成本管理

• API调用会使用您的Anthropic API积分，并可能产生费用
• 对于常规查询，请使用专业计划
• 只在您确实需要以下功能时才使用@claude-api：
  • 更长的上下文窗口
  • 自定义系统提示
  • 绕过速率限制

可用的MCP工具

1. query_claude

   • 直接向Claude发出API调用
   • 支持系统提示
   • 对话跟踪

2. clear_conversation

   • 重置对话历史
   • 管理多个对话线程

3. get_conversation_history

   • 获取对话记录
   • 调试对话流程

开发

主要的服务器实现在src/claude_api_server.py中。要扩展功能，您可以使用@mcp.tool()装饰器添加新的工具。

添加新工具的示例：

@mcp.tool()
async def custom_tool(param: str) -> str:
    """
    自定义工具描述
    
    参数：
        param: 参数描述
    """
    try:
        # 工具实现
        return result
    except Exception as e:
        return f"错误：{str(e)}"

故障排除

1. API密钥问题

   • 核实您的API密钥在.env中
   • 检查Claude Desktop配置路径
   • 确保API密钥具有正确的权限

2. 连接问题

   • 检查MCP服务器是否正在运行
   • 核实Python环境
   • 检查Claude Desktop日志

3. 使用问题

   • 确保正确使用@claude-api语法
   • 检查对话ID
   • 核实系统提示格式

贡献

1. 分叉仓库
2. 创建功能分支
3. 进行更改
4. 提交拉取请求

许可证

MIT

支持

对于问题和疑问：

1. 在仓库中打开一个问题
2. 查看现有讨论
3. 查阅故障排除指南