通过 MCP 集成 Claude Desktop API

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

功能

• 通过 MCP 直接集成 Claude API
• 对话历史记录跟踪和管理
• 系统提示支持
• 在 Professional Plan 和 API 使用之间无缝切换
• 易于配置 Claude Desktop

何时使用

• Professional Plan (默认):

  • Claude Desktop 中的常规对话
  • 计划限制内的基本使用
  • 无需特殊配置

• API Token (通过此 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 聊天
   • 使用您的 Professional Plan
   • 无需特殊命令

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 积分，并可能产生费用
• 使用 Professional Plan 进行常规查询
• 仅在您特别需要以下内容时才使用 @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:
    """
    自定义工具描述
    
    Args:
        param: 参数描述
    """
    try:
        # 工具实现
        return result
    except Exception as e:
        return f"Error: {str(e)}"

故障排除

1. API 密钥问题

   • 验证 .env 中的 API 密钥
   • 检查 Claude Desktop 配置路径
   • 确保 API 密钥具有正确的权限

2. 连接问题

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

3. 使用问题

   • 确保正确的 @claude-api 语法
   • 检查对话 ID
   • 验证系统提示格式

贡献

1. Fork 存储库
2. 创建一个功能分支
3. 进行更改
4. 提交 pull request

许可证

MIT

支持

对于问题和疑问：

1. 在存储库中打开一个 issue
2. 检查现有的讨论
3. 查看故障排除指南