gpt5-search-mcp

一个MCP服务器，可以使用OpenAI的gpt-5模型及其强大的Web搜索功能。 通过将其注册到任何AI编码代理，该代理可以自主地与gpt-5模型协商，以解决复杂的问题。

使用案例

🐛 调试卡住时

gpt-5的Web搜索可以广泛搜索GitHub issue和Stack Overflow等问题，因此解决小众问题的可能性大大增加。指示示例：

> 启动后出现以下错误，请修复。如果太难，请询问gpt-5
> [粘贴错误消息]

> WebSocket连接不成功。请调试。如果不知道，请询问gpt-5

📚 想要参考最新的库信息时

即使没有整理好的文档，也可以通过强大的Web搜索获得答案。指示示例：

> 我想将这个库升级到v2。请边咨询gpt-5边进行

> 我被告知该库的此选项不存在。也许它已被删除。请询问gpt-5应该指定什么来代替并替换它

🧩 处理复杂任务时

除了搜索之外，您还可以将其用作设计的讨论对象。指示示例：

> 我想创建一个可同时编辑的编辑器，请进行设计。并请gpt-5进行设计审查，必要时进行讨论。

此外，由于它是作为MCP服务器提供的，因此即使您不发出指示，AI代理也可能会自行判断必要性并自主地与gpt-5对话。这将极大地扩展其在自主运行中解决问题的范围！

安装

npx (推荐)

Claude Code:

$ claude mcp add gpt5 \
	-s user \  # 省略此行将在项目范围内安装
	-e OPENAI_API_KEY=your-api-key \
	-e SEARCH_CONTEXT_SIZE=medium \
	-e REASONING_EFFORT=medium \
	-e OPENAI_API_TIMEOUT=60000 \
	-e OPENAI_MAX_RETRIES=3 \
	-- npx gpt5-search-mcp

json:

{
  "mcpServers": {
    "gpt5-search": {
      "command": "npx",
      "args": ["gpt5-search-mcp"],
      "env": {
        "OPENAI_API_KEY": "your-api-key",
        // 可选: low, medium, high (默认: medium)
        "SEARCH_CONTEXT_SIZE": "medium",
        "REASONING_EFFORT": "medium",
        // 可选: API超时（毫秒） (默认: 60000)
        "OPENAI_API_TIMEOUT": "60000",
        // 可选: 最大重试次数 (默认: 3)
        "OPENAI_MAX_RETRIES": "3"
      }
    }
  }
}

本地设置

如果您想下载代码并在本地运行：

git clone [email protected]:raspi0124/gpt5-search-mcp.git
cd gpt5-search-mcp
npm install
npm run build

Claude Code:

$ claude mcp add gpt5 \
	-s user \  # 省略此行将在项目范围内安装
	-e OPENAI_API_KEY=your-api-key \
	-e SEARCH_CONTEXT_SIZE=medium \
	-e REASONING_EFFORT=medium \
	-e OPENAI_API_TIMEOUT=60000 \
	-e OPENAI_MAX_RETRIES=3 \
	-- node /path/to/gpt5-search-mcp/build/index.js

json:

{
  "mcpServers": {
    "gpt5-search": {
      "command": "node",
      "args": ["/path/to/gpt5-search-mcp/build/index.js"],
      "env": {
        "OPENAI_API_KEY": "your-api-key",
        // 可选: low, medium, high (默认: medium)
        "SEARCH_CONTEXT_SIZE": "medium",
        "REASONING_EFFORT": "medium",
        // 可选: API超时（毫秒） (默认: 60000)
        "OPENAI_API_TIMEOUT": "60000",
        // 可选: 最大重试次数 (默认: 3)
        "OPENAI_MAX_RETRIES": "3"
      }
    }
  }
}

环境变量

| 环境变量名 | 选项 | 默认值 | 说明 | | --- | --- | --- | --- | | OPENAI_API_KEY | 必需 | - | OpenAI API 密钥 | | SEARCH_CONTEXT_SIZE | 可选 | medium | 控制搜索上下文大小值: low, medium, high | | REASONING_EFFORT | 可选 | medium | 控制推理努力级别值: low, medium, high | | OPENAI_API_TIMEOUT | 可选 | 60000 | API请求超时（毫秒）示例: 120000 为2分钟 | | OPENAI_MAX_RETRIES | 可选 | 3 | 失败请求的最大重试次数SDK会在速率限制（429）、服务器错误（5xx）和连接错误时自动重试 | | OPENAI_MODEL | 可选 | gpt-5 | 使用的目标模型名称（例如: gpt-5, o3） |

注意事项

要从OpenAI API使用gpt-5模型，您的帐户需要具有对gpt-5的访问权限。 如果您向此MCP注册了尚未启用gpt-5的API密钥，则调用将导致错误。 参考: https://help.openai.com/en/articles/10362446-api-access-to-o1-o3-and-o4-models