氧气搜索MCP

Name: 氧气搜索MCP
Author: yoshiko-pg

作者：yoshiko-pg279 星标更新：2025-10-01

安装使用来源：spider==github.com

项目介绍

o3-search-mcp (支持 gpt-5 和 o4-mini)

<div align="center"> <p>English | <a href="./README.ja.md">日本語</a> | <a href="./README.zh.md">简体中文</a> | <a href="./README.ko.md">한국어</a></p>

</div>

这是一款MCP服务器，能够利用OpenAI的高端模型及其强大的网络搜索能力。通过将其注册到任何AI编码代理中，该代理可以自主地与OpenAI模型进行咨询以解决复杂问题。

使用场景

（尽管名为o3以匹配MCP名称，但可以通过环境变量指定使用gpt-5或o4-mini模型）

🐛 当您卡在调试时

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_MODEL=o3 \ # 也可选择o4-mini或gpt-5
	-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",
        // 可选：o3, o4-mini, gpt-5（默认：o3）
        "OPENAI_MODEL": "o3",
        // 可选：low, medium, high（默认：medium）
        "SEARCH_CONTEXT_SIZE": "medium",
        "REASONING_EFFORT": "medium",
        // 可选：API超时时间（毫秒，默认：300000）
        "OPENAI_API_TIMEOUT": "300000",
        // 可选：最大重试次数（默认：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_MODEL=o3 \ # 也可选择o4-mini或gpt-5
	-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",
        // 可选：o3, o4-mini, gpt-5（默认：o3）
        "OPENAI_MODEL": "o3",
        // 可选：low, medium, high（默认：medium）
        "SEARCH_CONTEXT_SIZE": "medium",
        "REASONING_EFFORT": "medium",
        // 可选：API超时时间（毫秒，默认：300000）
        "OPENAI_API_TIMEOUT": "300000",
        // 可选：最大重试次数（默认：3）
        "OPENAI_MAX_RETRIES": "3"
      }
    }
  }
}

环境变量

环境变量	选项	默认值	描述
`OPENAI_API_KEY`	必填	-	OpenAI API密钥
`OPENAI_MODEL`	可选	`o3`	要使用的模型<br>值：`o3`，`o4-mini`，`gpt-5`
`SEARCH_CONTEXT_SIZE`	可选	`medium`	控制搜索上下文大小<br>值：`low`，`medium`，`high`
`REASONING_EFFORT`	可选	`medium`	控制推理努力程度<br>值：`low`，`medium`，`high`
`OPENAI_API_TIMEOUT`	可选	`300000`	API请求超时时间（毫秒）<br>例如：`300000`表示5分钟
`OPENAI_MAX_RETRIES`	可选	`3`	失败请求的最大重试次数<br>SDK会自动在达到速率限制（429）、服务器错误（5xx）和连接错误时重试

注意事项

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