Claude Desktop API Integration via MCP

通过 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. 克隆仓库

   # Using VS Code:
   # 1. Press Cmd + Shift + P
   # 2. Type "Git: Clone"
   # 3. Paste: https://github.com/mlobo2012/Claude_Desktop_API_USE_VIA_MCP.git
   
   # Or using terminal:
   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. 配置环境

   # Copy environment template
   cp .env.example .env
   
   # Edit .env and add your API key
   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 Please answer using the API: What is the capital of France?
   

高级功能

1. 使用系统提示词

   @claude-api {"system_prompt": "You are an expert fitness coach"} Create a workout plan
   

2. 管理对话

   # Start a new conversation
   @claude-api {"conversation_id": "project1"} Let's discuss Python
   
   # Continue same conversation
   @claude-api {"conversation_id": "project1"} Tell me more
   
   # View conversation history
   @claude-api get_conversation_history project1
   
   # Clear conversation
   @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:
    """
    Custom tool description
    
    Args:
        param: Parameter description
    """
    try:
        # Tool implementation
        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. 查阅故障排除指南