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