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