项目简介

Claude Code Python Edition 是 Anthropic Claude Code CLI 工具的 Python 重新实现版本，旨在提供一个强大的命令行界面，用于软件开发任务。除了基本的 CLI 交互，此项目还扩展了 MCP 服务器功能，使其可以作为后端服务为支持 MCP 协议的客户端（如 Claude Desktop）提供资源、工具和 Prompt 模板。此外，它还集成了成本管理和实时的工具执行可视化功能。

主要功能点

MCP 服务器功能: 作为 MCP 服务器运行，支持资源管理、工具注册和 Prompt 模板定义，可以与 Claude Desktop 和其他 MCP 客户端协同工作。
多 LLM 提供商支持: 支持 OpenAI, Anthropic 等多种 LLM 提供商，可以灵活选择和配置不同的模型。
工具集成: 内置丰富工具套件，包括文件操作、搜索、Bash 命令执行等，扩展 LLM 的能力边界。
实时可视化: 提供工具执行过程的实时可视化，方便用户监控和理解工具的运行状态。
成本管理: 具备成本跟踪和预算控制功能，帮助用户管理 LLM API 的使用成本。
多 Agent 模式: 支持多 Agent 模式，允许不同角色 Agent 协同解决复杂问题。

安装步骤

克隆仓库

git clone https://github.com/arthurcolle/openai-mcp
cd openai-mcp

安装依赖

pip install -r requirements.txt

配置 API 密钥 创建 '.env' 文件，并根据需要添加 OpenAI 或 Anthropic 的 API 密钥。例如：

OPENAI_API_KEY=your_openai_api_key_here
# ANTHROPIC_API_KEY=your_anthropic_api_key_here

服务器配置

以下 JSON 配置信息可用于 MCP 客户端连接到 Claude Code Python Edition 服务器。请根据实际情况修改 'args' 中的主机和端口号。

{
  "serverName": "Claude Code MCP Server",
  "command": "python",
  "args": [
    "claude.py",
    "serve",
    "--host", "localhost",  // MCP 服务器主机地址，默认为 localhost
    "--port", "8000"      // MCP 服务器端口号，默认为 8000
  ],
  "env": {},
  "description": "Claude Code Python Edition MCP Server"
}

参数注释:

'serverName': MCP 服务器的名称，可自定义。
'command': 启动 MCP 服务器的命令，这里是 'python'。
'args': 启动命令的参数列表：
- '"claude.py"': 主程序入口脚本。
- '"serve"': 指定运行 MCP 服务器模式。
- '--host': 服务器绑定的主机地址，默认为 'localhost'，如需远程访问请设置为 '0.0.0.0'。
- '--port': 服务器监听的端口号，默认为 '8000'。
'env': 环境变量配置，默认为空。
'description': 服务器描述信息，可自定义。

基本使用方法

启动 MCP 服务器

在终端中，导航到仓库根目录，运行以下命令启动 MCP 服务器：

python claude.py serve

您可以使用 '--host' 和 '--port' 参数自定义服务器的主机和端口：

python claude.py serve --host 0.0.0.0 --port 8080

连接 MCP 客户端

使用 MCP 客户端（例如 Claude Desktop），按照其配置说明，填入上述 服务器配置 JSON 信息，即可连接到 Claude Code Python Edition MCP 服务器。连接成功后，客户端即可利用服务器提供的资源、工具和 Prompt 模板进行交互。

使用 CLI 客户端 (可选)

您也可以使用仓库自带的 CLI 客户端连接到 MCP 服务器进行测试或交互：

python claude.py mcp-client path/to/server.py

例如连接到本地 Echo 服务器示例：

# 启动 Echo 服务器 (在另一个终端)
python examples/echo_server.py

# 使用 Claude Code CLI 客户端连接 Echo 服务器
python claude.py mcp-client examples/echo_server.py

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息