O3 Search MCP

🚀 o3-search-mcp

o3-search-mcp 是一个 MCP 服务器，它能让你使用 OpenAI 的 o3 模型及其强大的网络搜索功能。将其注册到任何 AI 编码代理中，代理就能自主咨询 o3 模型，以解决复杂问题。

🚀 快速开始

本项目可助力 AI 编码代理借助 OpenAI 的 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