通过 MCP 集成 Claude 桌面 API

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

特征

• 通过 MCP 直接集成 Claude API

• 对话历史跟踪和管理

• 系统提示支持

• 专业计划和 API 使用之间的无缝切换

• 使用 Claude Desktop 轻松配置

何时使用

• 专业计划（默认）：

  • Claude Desktop 中的常规对话

  • 计划限制内的基本使用情况

  • 无需特殊配置

• API 令牌（通过此 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 桌面

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

     # Using Finder: # 1. Press Cmd + Shift + G # 2. Enter: ~/Library/Application Support/Claude/

   • Windows：导航至%APPDATA%\Claude\

   • 创建或编辑claude_desktop_config.json

   • 从config/claude_desktop_config.json复制内容

   • 更新路径和 API 密钥

使用指南

基本用法

1. 常规 Claude 桌面使用情况

   • 和克劳德正常聊天就行

   • 使用您的专业计划

   • 无需特殊命令

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 积分，可能会产生费用

• 使用专业计划进行常规查询

• 仅在您特别需要时使用@claude-api：

  • 更长的上下文窗口

  • 自定义系统提示

  • 绕过速率限制

MCP 工具可用

1. query_claude

   • 直接对 Claude 进行 API 调用

   • 支持系统提示

   • 对话追踪

2. clear_conversation

   • 重置对话历史记录

   • 管理多个对话线程

3. get_conversation_history

   • 检索对话记录

   • 调试对话流程

发展

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

添加新工具的示例：

故障排除

1. API 密钥问题

   • 在 .env 中验证您的 API 密钥

   • 检查 Claude Desktop 配置路径

   • 确保 API 密钥具有正确的权限

2. 连接问题

   • 检查 MCP 服务器是否正在运行

   • 验证 Python 环境

   • 检查 Claude Desktop 日志

3. 使用问题

   • 确保@claude-api语法正确

   • 检查对话 ID

   • 验证系统提示格式

贡献

1. 分叉存储库

2. 创建功能分支

3. 进行更改

4. 提交拉取请求

执照

麻省理工学院

支持

对于问题和疑问：

1. 在存储库中打开一个问题

2. 检查现有讨论

3. 查看故障排除指南