项目简介

本项目 'Claude API' 是一个 MCP 服务器的实现，它允许 Claude 桌面应用程序通过 Model Context Protocol (MCP) 连接到 Claude API。通过此服务器，用户可以绕过 Claude 专业版的一些限制，例如使用更长的上下文窗口、自定义系统提示和更灵活的会话管理。简而言之，它充当 Claude 桌面应用和 Claude API 之间的桥梁，通过 MCP 协议增强 Claude 桌面应用的功能。

主要功能点

Claude API 集成: 通过 MCP 协议，将 Claude API 的强大功能引入 Claude 桌面应用。
自定义系统提示: 允许用户为 Claude API 会话设置自定义的系统提示，以控制对话风格和行为。
会话管理: 支持创建、清除和查看会话历史记录，更好地组织和管理与 Claude API 的对话。
绕过专业版限制: 在一定程度上突破 Claude 桌面专业版的限制，例如可能获得更长的上下文窗口（取决于 Claude API 的能力）。

安装步骤

克隆仓库

使用 Git 命令克隆仓库到本地：

git clone https://github.com/mlobo2012/Claude_Desktop_API_USE_VIA_MCP.git
cd Claude_Desktop_API_USE_VIA_MCP

安装依赖

在项目根目录下，使用 pip 安装 Python 依赖：

pip install -r requirements.txt

配置环境变量

复制 '.env.example' 文件并重命名为 '.env'，然后编辑 '.env' 文件，填入你的 Anthropic API 密钥：
```
ANTHROPIC_API_KEY=你的API密钥
```
请确保你拥有有效的 Anthropic API 密钥。
配置 Claude 桌面应用

你需要修改 Claude 桌面应用的配置文件，以使其连接到此 MCP 服务器。
- 找到配置文件:
  - macOS: 打开 Finder，前往 '~/Library/Application Support/Claude/'
  - Windows: 打开文件资源管理器，输入 '%APPDATA%\Claude' 并前往
- 编辑 'claude_desktop_config.json': 在该目录下，创建或编辑 'claude_desktop_config.json' 文件，并将 'config/claude_desktop_config.json' 文件的内容复制到 'claude_desktop_config.json' 中。
- 检查配置: 'claude_desktop_config.json' 文件中应该包含了连接到 MCP 服务器的配置信息，例如服务器名称、命令和参数等。请仔细检查配置文件中的路径和 API 密钥设置是否正确。注意：仓库提供的 'config/claude_desktop_config.json' 文件可能需要根据你的实际环境进行调整，特别是路径信息。

服务器配置 (MCP 客户端配置)

对于 MCP 客户端（例如 Claude 桌面应用），需要配置以下 JSON 格式的信息以连接到此 MCP 服务器。通常在 Claude 桌面应用的配置文件 'claude_desktop_config.json' 中进行配置。

{
  "servers": [
    {
      "name": "ClaudeAPI",  // MCP 服务器名称，需要与服务器代码中 FastMCP("ClaudeAPI") 定义的名称一致
      "command": "python",   // 启动 MCP 服务器的命令，这里使用 python 解释器
      "args": [
        "src/claude_api_server.py" // MCP 服务器 Python 脚本的路径，相对于项目根目录
      ]
    }
  ]
}

配置参数说明:

'"name"': MCP 服务器的名称，客户端通过此名称识别服务器。必须与 'src/claude_api_server.py' 中 'FastMCP("ClaudeAPI")' 定义的名称完全一致。
'"command"': 启动 MCP 服务器的可执行命令。这里假设你已经安装了 Python 并且 'python' 命令在你的 PATH 环境变量中。
'"args"': 传递给启动命令的参数列表。这里指定了 MCP 服务器 Python 脚本的路径。请确保路径 'src/claude_api_server.py' 相对于 Claude 桌面应用启动时的当前工作目录是正确的。 如果 Claude 桌面应用和 MCP 服务器在不同的目录下，可能需要使用绝对路径或调整相对路径。

基本使用方法

配置完成后，启动 MCP 服务器（通常 Claude 桌面应用会自动启动配置的 MCP 服务器）。在 Claude 桌面应用中，你可以使用以下命令来与 Claude API 交互：

直接使用 API: 在 Claude 桌面应用中输入 '@claude-api' 开头的消息，即可通过 API 调用 Claude 模型。例如：

@claude-api 请使用 API 回答：法国的首都是哪里？

使用系统提示: 使用 JSON 格式指定 'system_prompt' 参数来设置系统提示：

@claude-api {"system_prompt": "你是一位专业的健身教练"} 制定一个健身计划

管理会话:

开始新会话: 使用 'conversation_id' 参数指定会话 ID 来开始或切换会话：

@claude-api {"conversation_id": "项目A"} 让我们讨论一下 Python

继续会话: 在后续消息中使用相同的 'conversation_id' 即可在同一会话中继续对话：

@claude-api {"conversation_id": "项目A"} 详细说说

查看会话历史: 使用 'get_conversation_history' 工具查看指定会话的记录：

@claude-api get_conversation_history 项目A

清除会话: 使用 'clear_conversation' 工具清除指定会话的记录：

@claude-api clear_conversation 项目A

请注意: 使用 API 调用会消耗你的 Anthropic API 额度，请合理使用。对于日常对话，可以继续使用 Claude 桌面应用的专业版功能。只有在需要使用 API 的高级功能（如自定义系统提示、会话管理等）时，才使用 '@claude-api' 命令。

关键词

项目简介

主要功能点

安装步骤

服务器配置 (MCP 客户端配置)

基本使用方法

信息