OpenAI Web Search MCP Server

OpenAI Web Search MCP サーバー

OpenAI の Web Search プレビュー機能を使用してウェブ検索機能を提供する、MCP サーバーの TypeScript 実装です。このサーバーは、web_search_preview 機能を備えた OpenAI の最新の Responses API を利用し、AI モデルが OpenAI API を通じてリアルタイムにウェブ検索できるようにします。

インストール

npx を使用して、このパッケージを直接実行できます。

npx openai-websearch-mcp-server

または、グローバルにインストールします。

npm install -g openai-websearch-mcp-server

MCP クライアントでの使用方法

このサーバーは、MCP（Model Context Protocol）クライアントで使用するように設計されています。各クライアントでの設定方法は次のとおりです。

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

このサーバーは、MCP プロトコルを通じて使用できるウェブ検索ツールを提供します。このツールの名前は web_search で、入力としてクエリ文字列を受け取ります。内部では、OpenAI の Responses API の web_search_preview 機能を使用してリアルタイムにウェブ検索を実行し、インターネット全体から最新情報を提供します。

開発

開発環境をセットアップするには、次の手順を実行します。

1. リポジトリをクローンします
2. 依存関係をインストールします。

   npm install
   

3. 開発サーバーを起動します。

   npm run dev
   

ビルド

パッケージをビルドするには、次のコマンドを実行します。

npm run build

ライセンス

MIT