o3-search MCP

o3搜索mcp（gpt-5，o4 mini支持）

English | 日本語 | 简体中文 | 한국어

MCP服务器，支持使用OpenAI的高端模型及其强大的网络搜索功能。 通过向任何AI编码代理注册它，代理可以自主地咨询OpenAI模型来解决复杂的问题。

用例

（虽然称为o3以匹配MCP名称，但您可以通过env指定gpt-5或o4-mini供模型使用）

🐛 当你陷入调试困境时

o3的网络搜索可以扫描各种来源，包括GitHub问题和Stack Overflow，大大增加了解决利基问题的机会。示例提示：

> I'm getting the following error on startup, please fix it. If it's too difficult, ask o3.
> [Paste error message here]

> The WebSocket connection isn't working. Please debug it. If you don't know how, ask o3.

📚 当你想参考最新的图书馆信息时

即使没有组织良好的文档，您也可以从强大的网络搜索中获得答案。示例提示：

> I want to upgrade this library to v2. Proceed while consulting with o3.

> I was told this option for this library doesn't exist. It might have been removed. Ask o3 what to specify instead and replace it.

🧩 处理复杂任务时

除了搜索，您还可以将其用作设计的发声板。示例提示：

> I want to create a collaborative editor, so please design it. Also, ask o3 for a design review and discuss if necessary.

此外，由于它是作为MCP服务器提供的，AI代理可以在认为必要时自行决定与o3通信，而无需您的任何指示。这将极大地扩大它自己可以解决的问题的范围！

安装

npx（推荐）

克劳德代码：

$ claude mcp add o3 \
	-s user \  # If you omit this line, it will be installed in the project scope
	-e OPENAI_MODEL=o3 \ # o4-mini, gpt-5 also available
	-e OPENAI_API_KEY=your-api-key \
	-e SEARCH_CONTEXT_SIZE=medium \
	-e REASONING_EFFORT=medium \
	-e OPENAI_API_TIMEOUT=300000 \
	-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",
        // Optional: o3, o4-mini, gpt-5 (default: o3)
        "OPENAI_MODEL": "o3",
        // Optional: low, medium, high (default: medium)
        "SEARCH_CONTEXT_SIZE": "medium",
        "REASONING_EFFORT": "medium",
        // Optional: API timeout in milliseconds (default: 300000)
        "OPENAI_API_TIMEOUT": "300000",
        // Optional: Maximum number of retries (default: 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 mcp add o3 \
	-s user \  # If you omit this line, it will be installed in the project scope
	-e OPENAI_MODEL=o3 \ # o4-mini, gpt-5 also available
	-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 \
	-- 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",
        // Optional: o3, o4-mini, gpt-5 (default: o3)
        "OPENAI_MODEL": "o3",
        // Optional: low, medium, high (default: medium)
        "SEARCH_CONTEXT_SIZE": "medium",
        "REASONING_EFFORT": "medium",
        // Optional: API timeout in milliseconds (default: 300000)
        "OPENAI_API_TIMEOUT": "300000",
        // Optional: Maximum number of retries (default: 3)
        "OPENAI_MAX_RETRIES": "3"
      }
    }
  }
}

环境变量

备注

要使用OpenAI API的o3模型，您需要将级别提高到4级，或者验证您的组织。 如果您在此MCP中注册尚未为o3启用的API密钥，则调用将导致错误。 参考：https://help.openai.com/en/articles/10362446-api-access-to-o1-o3-and-o4-models