gpt5MCP (Cristip73)

gpt5mcp

用于OpenAI GPT-5 API与Claude Code集成的MCP服务器。提供 gpt5_agent 和 gpt5_codex 工具。

设置

选项A：npm安装（推荐）

npm install -g gpt5mcp

# Basic (gpt5_agent only)
claude mcp add gpt5mcp -e OPENAI_API_KEY=sk-... -- gpt5mcp

# Full (with gpt5_codex support)
claude mcp add gpt5mcp \
  -e OPENAI_API_KEY=sk-... \
  -e CODEX_BIN=$(which codex) \
  -- gpt5mcp

选项B：来源

git clone https://github.com/cristip73/gpt5mcp.git
cd gpt5mcp
npm install
npm run build

claude mcp add gpt5mcp \
  -e OPENAI_API_KEY=sk-... \
  -e CODEX_BIN=$(which codex) \
  -- node /absolute/path/to/gpt5mcp/build/index.js

选项C：手动配置

创建/编辑 ~/.claude/.mcp.json:

{
  "mcpServers": {
    "gpt5mcp": {
      "command": "gpt5mcp",
      "env": {
        "OPENAI_API_KEY": "sk-...",
        "CODEX_BIN": "/path/from/which/codex"
      }
    }
  }
}

Codex CLI设置（用于 gpt5_codex 工具）

这 gpt5_codex 该工具需要OpenAI的Codex CLI。如果你只需要，跳过这个 gpt5_agent.

# Install Codex CLI
npm install -g @openai/codex

# Find the path
which codex
# Example output: /usr/local/bin/codex

# Use this path for CODEX_BIN

验证

重新启动Claude Code并检查：

claude mcp list

你应该看看 gpt5mcp 使用工具 gpt5_agent 和 gpt5_codex.

环境变量

主动工具

GPT-5试剂(gpt5_agent)

具有SSE流的自治代理，可解决复杂的多步任务。支持工具编排、web搜索、代码解释器和文件操作。

关键参数：

示例：

{
  "task": "Research the latest AI developments in 2026",
  "reasoning_effort": "high",
  "enable_web_search": true
}

{
  "task": "Analyze this Python code for performance issues",
  "file_path": "/path/to/code.py",
  "enable_code_interpreter": true
}

GPT-5食品法典(gpt5_codex)

通过Codex CLI进行深度代码分析。生成物 codex 用于自主代码编辑的二进制文件。

关键参数：

编辑模式：

• research -只读分析，无文件更改
• auto_edit -每次编辑前的提示
• full_auto -自动应用安全编辑
• dangerous -无限制（谨慎使用）

例子：

{
  "prompt": "Refactor this module to use async/await",
  "file_path": "/path/to/module.ts",
  "reasoning": "high",
  "edit_mode": "auto_edit"
}

非活动工具

默认情况下禁用性能。启用 src/tools/index.ts:

要启用：

// src/tools/index.ts
const ACTIVE_TOOLS = {
  gpt5_agent: true,
  gpt5_codex: true,
  image_generation: true,  // ← set to true
  // ...
};

然后： npm run build 并重新启动克劳德代码。

建筑

src/
├── index.ts              # MCP server entry point
├── utils.ts              # GPT-5 API utilities
├── types/
│   ├── responses.ts      # API response types
│   └── tools.ts          # Tool interface definitions
└── tools/
    ├── index.ts          # Tool registration & activation
    ├── registry.ts       # Tool registry (singleton)
    ├── base.ts           # Base tool class
    └── built-in/
        ├── gpt5-agent.ts     # ✅ Active
        ├── gpt5-codex.ts     # ✅ Active
        ├── web-search.ts
        ├── file-operations.ts
        ├── code-interpreter.ts
        ├── image-generation.ts
        └── function-definition.ts

流媒体实现

GPT-5代理使用SSE（服务器发送事件）来防止MCP超时：

• 活动超时：120秒无数据
• 请求超时：复杂任务最多15分钟
• 激活时间 reasoning_effort 不是 none 或 minimal

故障排除

找不到服务器：

claude mcp remove gpt5mcp
claude mcp add gpt5mcp -e OPENAI_API_KEY=sk-... -- gpt5mcp

套接字挂起错误：

• 确保 .mcp.json 指向 build/index.js （不是 dist/)
• SSE流处理长时间运行的请求

Codex不工作：

# 1. Install Codex CLI
npm install -g @openai/codex

# 2. Find path
which codex

# 3. Re-add MCP with correct path
claude mcp remove gpt5mcp
claude mcp add gpt5mcp -e OPENAI_API_KEY=sk-... -e CODEX_BIN=$(which codex) -- gpt5mcp

学分

最初灵感来自 关于艾YT。使用SSE流、Codex CLI集成和改进的工具架构进行了重大重写。

______________________________________________________________________

使用MCP构建•由OpenAI GPT-5提供支持