Openai WebSearch MCP Server

🚀 OpenAI ネットワーク検索 MCP サーバー

TypeScript で実装された MCP サーバーで、OpenAI のネットワーク検索プレビュー機能を利用したネットワーク検索機能を提供します。このサーバーは、OpenAI の最新のレスポンス API と web_search_preview 機能を活用し、AI モデルが OpenAI API を通じてリアルタイムのネットワーク検索を実行できるようにします。

🚀 クイックスタート

このサーバーは、OpenAI のネットワーク検索機能を MCP プロトコルを通じて利用できるようにするものです。以下の手順で簡単にセットアップできます。

📦 インストール

以下の方法でインストールできます。

npx を使用して直接実行

npx openai-websearch-mcp-server

グローバルインストール

npm install -g openai-websearch-mcp-server

💻 使用例

MCP クライアントとの連携

このサーバーは MCP（モデルコンテキストプロトコル）クライアントと一緒に使用するように設計されています。以下は他のクライアントとの設定方法です。

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 のレスポンス API と web_search_preview 機能を使用してリアルタイムのネットワーク検索を実行し、インターネットの様々なソースから最新の情報を取得します。

開発

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

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

npm install

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

npm run dev

ビルド

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

npm run build

📄 ライセンス

MIT