Openai WebSearch

🚀 OpenAI 网络搜索 MCP 服务器

此 MCP 服务器借助 Model Context Protocol 实现对 OpenAI 网络搜索功能的访问。在 AI 助手与用户对话时，它能进行网络搜索，提供可能不在助手训练数据中的最新信息。该服务器可安装并配置用于 Claude.app 或 Zed 编辑器。

🚀 快速开始

此 MCP 服务器可让 AI 助手在对话时进行网络搜索，为用户提供最新信息，还能安装配置到 Claude.app 或 Zed 编辑器中。

✨ 主要特性

• 通过 Model Context Protocol 访问 OpenAI 网络搜索功能。
• 支持在 AI 助手与用户对话期间进行网络搜索，提供最新信息。
• 可安装并配置用于 Claude.app 或 Zed 编辑器。

📦 安装指南

一键安装与配置

Claude

!! 使用此命令是否可以自动更新配置文件（推荐）

OPENAI_API_KEY=sk-xxxx uv run --with uv --with openai-websearch-mcp openai-websearch-mcp-install

sk-xxxx 是你的 API 密钥。你可以从 OpenAI 的开放平台 获取。

Cursor

即将推出

Windsurf

即将推出

手动安装和配置

请确保已安装 uvx 再进行安装。

配置 Claude

• 使用 uvx

"mcpServers": {
  "openai-websearch-mcp": {
    "command": "uvx",
    "args": ["openai-websearch-mcp"],
    "env": {
        "OPENAI_API_KEY": "your-api-key-here"
    }
  }
}

• 使用 pip 安装

1. 通过 pip 安装 openai-websearch-mcp：

pip install openai-websearch-mcp

2. 修改你的 Claude 设置

"mcpServers": {
  "openai-websearch-mcp": {
    "command": "python",
    "args": ["-m", "openai_websearch_mcp"],
    "env": {
        "OPENAI_API_KEY": "your-api-key-here"
    }
  }
}

配置 Zed

• 使用 uvx

"context_servers": [
  "openai-websearch-mcp": {
    "command": "uvx",
    "args": ["openai-websearch-mcp"],
    "env": {
        "OPENAI_API_KEY": "your-api-key-here"
    }
  }
],

• 使用 pip 安装

"context_servers": {
  "openai-websearch-mcp": {
    "command": "python",
    "args": ["-m", "openai_websearch_mcp"],
    "env": {
        "OPENAI_API_KEY": "your-api-key-here"
    }
  }
},

💻 使用示例

可用工具

• web_search - 作为工具调用 OpenAI 网络搜索。
  • 必要参数：
    • type (字符串)：web_search_preview
    • search_context_size (字符串)：上下文窗口大小的高层次指导。可以是 low、medium 或 high，其中 medium 是默认值。
    • user_location (对象或 null)
      • type (字符串)：用户的定位类型。始终为 approximate。
      • city (字符串)：用户所在城市的自由文本输入，例如 San Francisco。
      • country (字符串)：用户的两个字母 ISO 国家代码，例如 US。
      • region (字符串)：用户所在地区的自由文本输入，例如 California。
      • timezone (字符串)：用户的 IANA 时区，例如 America/Los_Angeles。

🔧 技术细节

你可以使用 MCP 检查器来调试服务器。对于 uvx 安装：

npx @modelcontextprotocol/inspector uvx openai-websearch-mcp