← 返回目录

o3 Search MCP Server

社区

将 OpenAI 高级模型和强大的网络搜索能力整合到 AI 编码代理中的 MCP 服务器。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他
Stars: ★ 286 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 13 个月前 ⚠

34FMRS · D

该服务器提供了通过 MCP 集成 OpenAI 高级模型搜索能力的简便方法，适用于需要实时信息的编码场景。但需要 OpenAI API 密钥和可能的权限要求。

最强项 · 文档质量 12/20 最弱项 · 可靠性 4/20

可靠性

4/20

安全与权限

6/20

维护活跃度

6/20

文档质量

12/20

安装易用性

6/20

查看各项评分依据

可靠性 4/20: 仅从README看，安装和配置清晰，但缺少源代码和测试证据，无法验证实际行为。未发现任何测试或CI配置，因此无法确认核心路径可复现。
安全与权限 6/20: API密钥通过环境变量传递，未硬编码。但缺少源代码审计，无法评估数据边界和潜在泄漏。README未提及权限最小化或操作确认，但该服务器仅作为搜索代理，风险可控。
维护活跃度 6/20: 仓库活跃（288星，1个未解决问题），但缺少发布和依赖更新记录。有MIT许可证，但未发现安全响应渠道。
文档质量 12/20: README提供了详细的安装、配置和示例提示，涵盖环境变量和端点的使用。但缺少故障排除和成本说明，文档质量中等偏上。
安装易用性 6/20: 提供了npx和本地安装的示例配置，步骤明确。但未提供可直接运行的CI或测试，且依赖手动安装和配置，评分受限。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

使用 Claude Code 或其他 AI 编码代理的开发者，希望在编码过程中获得实时信息。
需要解决罕见错误或缺乏文档问题的开发者。
需要设计评审或复杂问题解决支持的开发者。

不适合谁

不希望依赖 OpenAI API 或没有 OpenAI API 密钥的用户。
需要非 OpenAI 模型搜索能力的用户。
需要离线搜索或本地搜索能力的用户。

所需权限

需要有效的 OpenAI API 密钥，并可能需要 API 层级 4 或组织验证才能使用 o3 模型。
服务器通过网络访问 OpenAI API，可能需要网络连接。
安装时可能需要写入配置目录的权限。

风险与副作用

API 密钥泄露风险：请确保密钥安全，不要提交到公开仓库。
API 使用可能产生费用，请注意用量监控。
AI 代理可能根据搜索结果产生不准确信息，需人工验证。
依赖 OpenAI 服务的可用性，可能受到服务中断或限流影响。

安装接入

准备工作

运行环境：Node.js

OPENAI_API_KEY 必填密钥 OpenAI API 密钥，必填，从 OpenAI 平台获取，且账户需已开通 o3 访问（Tier 4 或已完成组织验证）。

其他可选配置项（5 个）

OPENAI_MODEL 可选指定使用的模型，可选 o3、o4-mini 或 gpt-5，默认 o3。

SEARCH_CONTEXT_SIZE 可选控制搜索上下文大小，可选 low/medium/high，默认 medium。

REASONING_EFFORT 可选控制推理力度，可选 low/medium/high，默认 medium。

OPENAI_API_TIMEOUT 可选 API 请求超时毫秒数，默认 300000（5 分钟）。

OPENAI_MAX_RETRIES 可选失败请求最大重试次数，默认 3，SDK 会对 429、5xx 及连接错误自动重试。

推荐使用 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"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "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"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add o3-search -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

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 Claude Code 中运行 claude mcp add 命令注册后，启动客户端查看 o3 相关工具是否出现，并让其咨询 o3 检索一个问题以确认连通。

常见排障

如果调用失败，请检查 OPENAI_API_KEY 是否正确配置，并且账户是否有权限访问所选的模型（如 o3）。
确认网络连接正常。
如果遇到速率限制或超时，可以调整 OPENAI_MAX_RETRIES 和 OPENAI_API_TIMEOUT。
确保 MCP 配置中的命令和参数正确。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

我启动时遇到以下错误，请修复它。如果太难就问 o3。（粘贴错误信息）
WebSocket 连接不上，请帮我调试。如果不知道怎么办就问 o3。
我想把这个库升级到 v2，请边咨询 o3 边进行。
我想做一个协作编辑器，请设计一下，并让 o3 做设计评审，必要时进行讨论。

使用场景

当调试遇到棘手问题时，让 o3 搜索广泛来源（如 GitHub issues 和 Stack Overflow）来找到解决方案。

需要参考最新库文档时，利用 o3 的网络搜索获取即使没有良好文档也能获得的答案。

处理复杂设计任务时，将 o3 作为设计评审和讨论的伙伴。

在无人干预的情况下，AI 代理可自主决定与 o3 交流以解决自身无法处理的问题。

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

o3-search-mcp 是一个 MCP 服务器，使得 AI 编码代理（如 Claude Code）能够自主调用 OpenAI 高级模型进行网络搜索，从而解决复杂问题。通过该服务器，代理可以访问实时信息，包括 GitHub issues 和 Stack Overflow 等，显著提高调试效率和解决罕见问题的能力。该服务器支持指定 OpenAI 模型（如 o3、o4-mini、gpt-5），并可配置搜索上下文大小和推理努力等参数。

o3 Search MCP Server

选型与风险

适合谁

不适合谁

所需权限

风险与副作用

安装接入

准备工作

验证是否装好

常见排障

试试这样问

使用场景

支持客户端

详细介绍

同类可选方案