STARWARCLOUD STARWAR.AI
返回市场
克劳德桌面API使用通过MCP

克劳德桌面API使用通过MCP

作者：mlobo201222 星标更新：2025-01-19
安装使用来源：spider==github.com

项目介绍

通过MCP集成Claude Desktop API

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

功能

  • 通过MCP直接集成Claude API
  • 对话历史记录跟踪和管理
  • 系统提示支持
  • 在专业计划和API使用之间无缝切换
  • 使用Claude Desktop进行简单配置

使用场景

  • 专业计划（默认）：

    • 在Claude Desktop中进行常规对话
    • 在计划限制内进行基本使用
    • 不需要特殊配置

  • API令牌（通过此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聊天
    • 使用您的专业计划
    • 不需要特殊命令

  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积分，并可能产生费用
  • 对于常规查询，请使用专业计划
  • 只在您确实需要以下功能时才使用@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:
    """
    自定义工具描述
    
    参数：
        param: 参数描述
    """
    try:
        # 工具实现
        return result
    except Exception as e:
        return f"错误：{str(e)}"

故障排除

  1. API密钥问题

    • 核实您的API密钥在.env中
    • 检查Claude Desktop配置路径
    • 确保API密钥具有正确的权限

  2. 连接问题

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

  3. 使用问题

    • 确保正确使用@claude-api语法
    • 检查对话ID
    • 核实系统提示格式

贡献

  1. 分叉仓库
  2. 创建功能分支
  3. 进行更改
  4. 提交拉取请求

许可证

MIT

支持

对于问题和疑问：

  1. 在仓库中打开一个问题
  2. 查看现有讨论
  3. 查阅故障排除指南