基本能力
产品定位
OpenAI WebSearch MCP Server 是一个提供网页搜索功能的 MCP 服务器,旨在为 AI 助手提供实时网络信息查询能力。
核心功能
- 提供
web_search
工具,调用 OpenAI 的网页搜索功能 - 支持参数配置:
type
: 指定搜索类型(web_search_preview)search_context_size
: 控制搜索上下文窗口大小(low/medium/high)user_location
: 用户位置信息(城市、国家、地区、时区等)
适用场景
- AI 助手需要获取实时网络信息时
- 需要补充训练数据之外的最新信息时
- 需要基于用户位置提供本地化搜索结果时
工具列表
web_search
: 调用 OpenAI 网页搜索工具- 能力:执行网络搜索并返回结果,支持位置感知搜索
常见问题解答
- 如何获取 API 密钥?
- 从 OpenAI 开放平台获取:https://platform.openai.com/
- 如何调试服务器?
- 使用 MCP inspector 工具进行调试
使用教程
使用依赖
需要先安装 uvx
工具
安装教程
一键安装(推荐)
bash
OPENAI_API_KEY=sk-xxxx uv run --with uv --with openai-websearch-mcp openai-websearch-mcp-install
手动安装
-
使用 pip 安装:
bash
pip install openai-websearch-mcp -
配置 Claude 设置:
json
"mcpServers": {
"openai-websearch-mcp": {
"command": "python",
"args": ["-m", "openai_websearch_mcp"],
"env": {
"OPENAI_API_KEY": "your-api-key-here"
}
}
} -
配置 Zed 设置:
json
"context_servers": {
"openai-websearch-mcp": {
"command": "python",
"args": ["-m", "openai_websearch_mcp"],
"env": {
"OPENAI_API_KEY": "your-api-key-here"
}
}
},
调试方式
使用 MCP inspector 进行调试:
bash
npx @modelcontextprotocol/inspector uvx openai-websearch-mcp