OpenAI WebSearch MCP Server

OpenAI WebSearch MCP Server

site icon
2025.03.14 34
Python网页搜索AI辅助工具搜索工具
OpenAI WebSearch MCP Server 是一个通过 Model Context Protocol 提供 OpenAI 网页搜索功能的服务器。它允许 AI 助手在与用户对话时搜索网页,提供可能不在助手训练数据中的最新信息。该服务器可以安装并配置用于 Claude.app 或 Zed 编辑器。
View on GitHub

Overview

基本能力

产品定位

OpenAI WebSearch MCP Server 是一个提供网页搜索功能的 MCP 服务器,旨在为 AI 助手提供实时网络信息查询能力。

核心功能

  • 提供 web_search 工具,调用 OpenAI 的网页搜索功能
  • 支持参数配置:
    • type: 指定搜索类型(web_search_preview)
    • search_context_size: 控制搜索上下文窗口大小(low/medium/high)
    • user_location: 用户位置信息(城市、国家、地区、时区等)

适用场景

  1. AI 助手需要获取实时网络信息时
  2. 需要补充训练数据之外的最新信息时
  3. 需要基于用户位置提供本地化搜索结果时

工具列表

  • web_search: 调用 OpenAI 网页搜索工具
  • 能力:执行网络搜索并返回结果,支持位置感知搜索

常见问题解答

  1. 如何获取 API 密钥?
  2. 从 OpenAI 开放平台获取:https://platform.openai.com/
  3. 如何调试服务器?
  4. 使用 MCP inspector 工具进行调试

使用教程

使用依赖

需要先安装 uvx 工具

安装教程

一键安装(推荐)

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

手动安装

  1. 使用 pip 安装:
pip install openai-websearch-mcp
  1. 配置 Claude 设置:
"mcpServers": {
  "openai-websearch-mcp": {
    "command": "python",
    "args": ["-m", "openai_websearch_mcp"],
    "env": {
        "OPENAI_API_KEY": "your-api-key-here"
    }
  }
}
  1. 配置 Zed 设置:
"context_servers": {
  "openai-websearch-mcp": {
    "command": "python",
    "args": ["-m", "openai_websearch_mcp"],
    "env": {
        "OPENAI_API_KEY": "your-api-key-here"
    }
  }
},

调试方式

使用 MCP inspector 进行调试:

npx @modelcontextprotocol/inspector uvx openai-websearch-mcp

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。