通过 MCP 集成 Claude 桌面 API
该项目提供了一个 MCP 服务器实现,可实现 Claude Desktop 与 Claude API 之间的无缝集成。它允许您绕过专业计划的限制,并使用自定义系统提示和对话管理等高级功能。
特征
通过 MCP 直接集成 Claude API
对话历史跟踪和管理
系统提示支持
专业计划和 API 使用之间的无缝切换
使用 Claude Desktop 轻松配置
Related MCP server: Code Analysis MCP Server
何时使用
专业计划(默认):
Claude Desktop 中的常规对话
计划限制内的基本使用情况
无需特殊配置
API 令牌(通过此 MCP 服务器):
当您需要更长的上下文窗口时
使用自定义系统提示
绕过速率限制
用于高级对话管理
设置说明
克隆存储库
# 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安装依赖项
pip install -r requirements.txt配置环境
# Copy environment template cp .env.example .env # Edit .env and add your API key ANTHROPIC_API_KEY=your_api_key_here配置 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 密钥
使用指南
基本用法
常规 Claude 桌面使用情况
和克劳德正常聊天就行
使用您的专业计划
无需特殊命令
API 使用
@claude-api Please answer using the API: What is the capital of France?
高级功能
使用系统提示
@claude-api {"system_prompt": "You are an expert fitness coach"} Create a workout plan管理对话
# 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 工具可用
query_claude直接对 Claude 进行 API 调用
支持系统提示
对话追踪
clear_conversation重置对话历史记录
管理多个对话线程
get_conversation_history检索对话记录
调试对话流程
发展
主服务器实现位于src/claude_api_server.py中。要扩展功能,可以使用@mcp.tool()装饰器添加新工具。
添加新工具的示例:
故障排除
API 密钥问题
在 .env 中验证您的 API 密钥
检查 Claude Desktop 配置路径
确保 API 密钥具有正确的权限
连接问题
检查 MCP 服务器是否正在运行
验证 Python 环境
检查 Claude Desktop 日志
使用问题
确保@claude-api语法正确
检查对话 ID
验证系统提示格式
贡献
分叉存储库
创建功能分支
进行更改
提交拉取请求
执照
麻省理工学院
支持
对于问题和疑问:
在存储库中打开一个问题
检查现有讨论
查看故障排除指南