O3 Search MCP

🚀 o3-search-mcp

o3-search-mcp 是一个 MCP 服务器，它支持使用 OpenAI 的 o3 模型及其强大的网络搜索功能。只需将其注册到任何 AI 编码代理中，该代理就能自主与 o3 模型协作，解决复杂问题。

🚀 快速开始

将 o3-search-mcp 注册到 AI 编码代理后，代理便能借助 o3 模型的能力，自主解决复杂问题。以下是不同场景下的使用示例：

🐛 调试遇阻时

o3 的网络搜索功能能够扫描包括 GitHub 问题和 Stack Overflow 在内的广泛资源，极大地提高解决小众问题的概率。示例提示如下：

> 启动时出现以下错误，请修复。如果太难，请询问 o3。
> [在此粘贴错误信息]

> WebSocket 连接无法正常工作，请进行调试。如果你不知道如何操作，请询问 o3。

📚 引用最新库信息时

即使没有组织良好的文档，你也能通过强大的网络搜索获得答案。示例提示如下：

> 我想将这个库升级到 v2，请在咨询 o3 的同时进行操作。

> 有人告诉我这个库的这个选项不存在，可能已被移除。请询问 o3 应该指定什么来替代它并进行替换。

🧩 处理复杂任务时

除了搜索，你还可以将其用作设计的参谋。示例提示如下：

> 我想创建一个协作编辑器，请进行设计。同时，询问 o3 进行设计评审，并在必要时进行讨论。

此外，由于它以 MCP 服务器的形式提供，AI 代理在认为必要时可以自行决定与 o3 对话，无需你的任何指令，这将极大地扩展其自主解决问题的范围！

📦 安装指南

npx（推荐）

Claude Code 安装方式：

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

JSON 配置方式：

{
  "mcpServers": {
    "o3-search": {
      "command": "npx",
      "args": ["o3-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 git@github.com:yoshiko-pg/o3-search-mcp.git
cd o3-search-mcp
pnpm install
pnpm build

Claude Code 安装方式：

$ claude mcp add o3 \
    -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/o3-search-mcp/build/index.js

JSON 配置方式：

{
  "mcpServers": {
    "o3-search": {
      "command": "node",
      "args": ["/path/to/o3-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 使用 o3 模型，你需要将账户级别提升到 4 级，或者验证你的组织。如果将尚未启用 o3 的 API 密钥注册到这个 MCP 中，调用将会出错。 参考文档：https://help.openai.com/en/articles/10362446-api-access-to-o1-o3-and-o4-models