使用说明

项目简介

本项目 'ChatGPT MCP Server' 是一个实现了 Model Context Protocol (MCP) 的服务器，它允许你通过兼容 MCP 协议的客户端（如 Claude Desktop）直接访问 OpenAI 的 ChatGPT API。该服务器充当中间层，将客户端的 MCP 请求转换为 ChatGPT API 调用，并将响应返回给客户端。

主要功能点

ChatGPT API 访问: 允许 MCP 客户端调用 OpenAI 的 ChatGPT 模型，进行对话交互。
可配置参数: 支持自定义 ChatGPT API 的模型版本、温度 (temperature)、最大 tokens 等参数。
网络搜索: 提供集成网络搜索功能的工具，使 ChatGPT 能够获取最新的互联网信息。
会话状态管理: 利用 OpenAI 的 Responses API 自动管理对话状态，实现连续对话。
工具集成: 提供 'ask_chatgpt' 和 'ask_chatgpt_with_web_search' 两个工具供 MCP 客户端调用。

安装步骤

克隆仓库: 首先，将 'mcp-chatgpt-responses' 仓库克隆到本地：

git clone https://github.com/billster45/mcp-chatgpt-responses.git
cd mcp-chatgpt-responses

安装 Python 依赖: 确保你的系统已安装 Python 3.10 或更高版本。然后，使用 'uv' (或 'pip') 创建虚拟环境并安装依赖：

uv venv

激活虚拟环境：

.venv\\Scripts\\activate  # Windows
# source .venv/bin/activate # macOS/Linux

安装依赖包：

uv pip install -r requirements.txt

配置 OpenAI API 密钥: 你需要拥有一个 OpenAI API 密钥。访问 OpenAI API 密钥页面获取。将 API 密钥设置为环境变量 'OPENAI_API_KEY'。你可以在 '.env' 文件中设置，或者直接在运行服务器的环境中设置。例如，在 Claude Desktop 的服务器配置中设置环境变量。

服务器配置

要将 'ChatGPT MCP Server' 添加到 MCP 客户端（例如 Claude Desktop），你需要配置服务器的启动命令。以下是 Claude Desktop 配置文件 ('config.json') 中 'mcpServers' 部分的配置示例：

{
  "mcpServers": {
    "chatgpt": {
      "command": "uv",
      "args": [
        "--directory",
        "\\path\\to\\mcp-chatgpt-responses",  //  将这里替换为你的 mcp-chatgpt-responses 仓库的本地路径
        "run",
        "chatgpt_server.py"
      ],
      "env": {
        "OPENAI_API_KEY": "your-api-key-here",  // 将这里替换为你的 OpenAI API 密钥
        "DEFAULT_MODEL": "gpt-4o",             // (可选) 默认使用的 ChatGPT 模型，默认为 gpt-4o
        "DEFAULT_TEMPERATURE": "0.7",          // (可选) 默认温度参数，范围 0-2，默认为 0.7
        "MAX_TOKENS": "1000"                   // (可选) 默认最大 tokens 数，默认为 1000
      }
    }
  }
}

配置参数说明:

'"chatgpt"': 服务器名称，可以自定义，在 Claude 中使用时需要引用此名称。
'"command": "uv"': 启动服务器的命令，这里使用 'uv run' 来运行 Python 脚本。如果你的环境中 'python' 或 'python3' 直接可用，也可以使用 '"command": "python"' 或 '"command": "python3"'。
'"args"': 传递给 'command' 的参数列表。
- '"--directory", "\path\to\mcp-chatgpt-responses"': 指定 'uv run' 命令的工作目录为仓库路径。请务必将 '\path\to\mcp-chatgpt-responses' 替换为你的本地仓库绝对路径。
- '"run", "chatgpt_server.py"': 使用 'uv run' 命令执行 'chatgpt_server.py' 脚本。
'"env"': 环境变量配置。
- '"OPENAI_API_KEY": "your-api-key-here"': 必须配置 OpenAI API 密钥，请替换为你的真实密钥。
- '"DEFAULT_MODEL"', '"DEFAULT_TEMPERATURE"', '"MAX_TOKENS"': 可选配置，可以设置 ChatGPT API 的默认模型、温度和最大 tokens 数。

注意: 请根据你的实际环境调整 'command' 和 'args' 中的路径。确保 Claude Desktop 的配置文件中 'mcpServers' 部分的 JSON 格式正确。

基本使用方法

配置完成后，重启你的 MCP 客户端（如 Claude Desktop）。你就可以通过客户端指示其使用 'chatgpt' 服务器提供的工具来与 ChatGPT 交互了。

示例用法 (在 Claude Desktop 中):

使用 'ask_chatgpt' 工具提问:

使用 ask_chatgpt 工具回答：学习 Python 的最佳方法是什么？

使用 'ask_chatgpt_with_web_search' 工具获取最新信息:

使用 ask_chatgpt_with_web_search 工具回答：量子计算的最新进展是什么？

进行连续对话: 'ask_chatgpt' 和 'ask_chatgpt_with_web_search' 工具都支持 'response_id' 参数，用于在连续对话中保持上下文。服务器会自动处理 'response_id'，你只需要在对话中持续使用相应的工具即可。

通过以上配置和使用方法，你就可以在 MCP 客户端中方便地使用 ChatGPT API 和网络搜索功能了。

关键词