MIT License
34
最近更新:4个月前

OpenAI 网络搜索工具作为 MCP 服务器

OpenAI WebSearch MCP 服务器

该 MCP 服务器通过模型上下文协议(Model Context Protocol)提供对 OpenAI 网页搜索功能的访问。它允许 AI 助手在与用户对话过程中搜索网页,提供可能未包含在助手训练数据中的最新信息。该服务器可安装并配置用于 Claude.app 或 Zed 编辑器。

一键安装与配置

Claude

!!使用此命令可自动更新配置文件(推荐)

bash 复制代码
OPENAI_API_KEY=sk-xxxx uv run --with uv --with openai-websearch-mcp openai-websearch-mcp-install

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

Cursor

即将推出

Windsurf

即将推出

可用工具

  • web_search - 调用 OpenAI 网页搜索作为工具
    • 必填参数:
      • type (字符串): web_search_preview
      • search_context_size (字符串): 搜索上下文窗口空间使用量的高级指导。可选值为 low、medium 或 high。默认值为 medium
      • user_location (对象或 null)
        • type (字符串): 位置类型 > approximation。始终为 approximate
        • city (字符串): 用户所在城市的自由文本输入,例如 San Francisco
        • country (字符串): 用户所在国家的两字母 ISO 代码,例如 US
        • region (字符串): 用户所在地区的自由文本输入,例如 California
        • timezone (字符串): 用户的 IANA 时区,例如 America/Los_Angeles

手动安装与配置

安装前请确保已安装 uvx

添加到 Claude 设置中:

1、使用 uvx

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

2、使用 pip 安装

1)通过 pip 安装 openai-websearch-mcp:

bash 复制代码
pip install openai-websearch-mcp

2)修改 Claude 设置

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

为 Zed 配置

添加到 Zed 的 settings.json 中:

使用 uvx

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

使用 pip 安装

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

调试

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

bash 复制代码
npx @modelcontextprotocol/inspector uvx openai-websearch-mcp