适合谁
- 使用 Claude Code 或其他 AI 编码代理的开发者，希望在编码过程中获得实时信息。
- 需要解决罕见错误或缺乏文档问题的开发者。
- 需要设计评审或复杂问题解决支持的开发者。
O
34FMRS · D
该服务器提供了通过 MCP 集成 OpenAI 高级模型搜索能力的简便方法，适用于需要实时信息的编码场景。但需要 OpenAI API 密钥和可能的权限要求。
o3-search-mcp 是一个 MCP 服务器，使得 AI 编码代理（如 Claude Code）能够自主调用 OpenAI 高级模型进行网络搜索，从而解决复杂问题。通过该服务器，代理可以访问实时信息，包括 GitHub issues 和 Stack Overflow 等，显著提高调试效率和解决罕见问题的能力。该服务器支持指定 OpenAI 模型（如 o3、o4-mini、gpt-5），并可配置搜索上下文大小和推理努力等参数。
工具能力
暂未整理工具清单。
安装接入
推荐使用 npx 安装：运行 claude mcp add o3 -s user -e OPENAI_API_KEY=your-api-key -e OPENAI_MODEL=o3 -e SEARCH_CONTEXT_SIZE=medium -e REASONING_EFFORT=medium -e OPENAI_API_TIMEOUT=300000 -e OPENAI_MAX_RETRIES=3 -- npx o3-search-mcp。也可以下载仓库源码在本地构建后运行：git clone [email protected]:yoshiko-pg/o3-search-mcp.git && cd o3-search-mcp && pnpm install && pnpm build，然后配置执行 node /path/to/o3-search-mcp/build/index.js。
claude_desktop_config.json
{
"mcpServers": {
"o3-search": {
"command": "npx",
"args": [
"o3-search-mcp"
],
"env": {
"OPENAI_API_KEY": "your-api-key",
"OPENAI_MODEL": "o3",
"SEARCH_CONTEXT_SIZE": "medium",
"REASONING_EFFORT": "medium",
"OPENAI_API_TIMEOUT": "300000",
"OPENAI_MAX_RETRIES": "3"
}
}
}
}
选型与风险
不适合谁
- 不希望依赖 OpenAI API 或没有 OpenAI API 密钥的用户。
- 需要非 OpenAI 模型搜索能力的用户。
- 需要离线搜索或本地搜索能力的用户。
所需权限
- 需要有效的 OpenAI API 密钥，并可能需要 API 层级 4 或组织验证才能使用 o3 模型。
- 服务器通过网络访问 OpenAI API，可能需要网络连接。
- 安装时可能需要写入配置目录的权限。
风险与副作用
- API 密钥泄露风险：请确保密钥安全，不要提交到公开仓库。
- API 使用可能产生费用，请注意用量监控。
- AI 代理可能根据搜索结果产生不准确信息，需人工验证。
- 依赖 OpenAI 服务的可用性，可能受到服务中断或限流影响。
常见排障
- 如果调用失败，请检查 OPENAI_API_KEY 是否正确配置，并且账户是否有权限访问所选的模型（如 o3）。
- 确认网络连接正常。
- 如果遇到速率限制或超时，可以调整 OPENAI_MAX_RETRIES 和 OPENAI_API_TIMEOUT。
- 确保 MCP 配置中的命令和参数正确。
使用场景
当调试遇到棘手问题时，让 o3 搜索广泛来源（如 GitHub issues 和 Stack Overflow）来找到解决方案。
需要参考最新库文档时，利用 o3 的网络搜索获取即使没有良好文档也能获得的答案。
处理复杂设计任务时，将 o3 作为设计评审和讨论的伙伴。
在无人干预的情况下，AI 代理可自主决定与 o3 交流以解决自身无法处理的问题。
支持客户端
Claude Desktop完整支持