Openai WebSearch MCP Server

🚀 OpenAI 網絡搜索 MCP 服務器

本項目是一個用 TypeScript 實現的 MCP 服務器，為用戶提供基於 OpenAI 的網絡搜索預覽功能。藉助 OpenAI 最新的響應 API 和 web_search_preview 功能，AI 模型可通過 OpenAI API 實現即時網絡搜索，獲取互聯網上的最新信息。

🚀 快速開始

本服務器可直接使用 npx 運行，也能全局安裝後使用。同時，它設計用於與 MCP（模型上下文協議）客戶端配合，如 Claude Desktop。使用前需配置好 OpenAI API 密鑰。

✨ 主要特性

• 採用 TypeScript 實現，提供穩定的 MCP 服務器。
• 利用 OpenAI 最新響應 API 和 web_search_preview 功能，支持 AI 模型即時網絡搜索。
• 可與 MCP 客戶端無縫集成，如 Claude Desktop。

📦 安裝指南

直接使用 npx 運行

npx openai-websearch-mcp-server

全局安裝

npm install -g openai-websearch-mcp-server

💻 使用示例

與 Claude Desktop 一起使用

在您的 Claude Desktop 設置中添加以下配置：

{
  "mcpServers": {
    "openai_websearch": {
      "command": "npx",
      "args": [
        "-y",
        "openai-websearch-mcp-server"
      ],
      "env": {
        "OPENAI_API_KEY": "your_api_key"
      }
    }
  }
}

請將 your_api_key 替換為您實際的 OpenAI API 密鑰。

環境配置

1. 設置 OpenAI API 密鑰為環境變量：

export OPENAI_API_KEY='your-api-key-here'

2. 運行服務器：

openai-websearch-mcp

默認情況下，服務器運行在 3000 端口。您可以通過設置 PORT 環境變量更改端口：

PORT=8080 openai-websearch-mcp

📚 詳細文檔

API

該服務器提供一個名為 web_search 的網絡搜索工具，可通過 MCP 協議使用。此工具接受查詢字符串作為輸入，底層利用 OpenAI 的響應 API 和 web_search_preview 功能實現即時網絡搜索，從互聯網各個來源獲取最新信息。

開發

要設置開發環境，請按以下步驟操作：

1. 克隆倉庫。
2. 安裝依賴：

npm install

3. 啟動開發服務器：

npm run dev

構建

要構建包，請運行以下命令：

npm run build

📄 許可證

本項目採用 MIT 許可證。