AI导哈

Claude API集成工具

通过MCP服务器实现Claude Desktop与Claude API的无缝集成，提供自定义系统提示和对话管理功能。

  • by mlobo2012
  • Python
  • 本地部署
  • 34 星标
  • 更新于
在 GitHub 查看 mlobo2012/Claude_Desktop_API_USE_VIA_MCP

使用说明

Claude Desktop API通过MCP集成

该项目提供了一个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

    • 直接打API电话给Claude
    • 支持系统提示
    • 对话跟踪

  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环境
    • 检查克劳德桌面日志

  3. 使用问题

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

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 提交拉取请求

许可证

麻省理工学院

支持

对于问题和疑问：

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

相关 MCP