SSE サポートを備えた Brave Search MCP

これは、Server-Sent Events（SSE）統合によるBrave Search機能を提供するModel Context Protocol（MCP）サーバーです。Coolifyにデプロイして、リアルタイム検索サービスとして使用できます。

特徴

• MCP を介した Brave Search API の統合

• SSEを使用したリアルタイム検索結果

• DockerとCoolifyに対応

• TypeScript実装

• Express.js SSEエンドポイント

前提条件

• Brave Search APIキー

• Node.js 18歳以上

• Docker（コンテナ化されたデプロイメント用）

• Coolifyインスタンス

地域開発

1. リポジトリをクローンする

2. Brave API キーを使用して.envファイルを作成します。

   BRAVE_API_KEY=your_api_key_here PORT=3001

3. 依存関係をインストールします:

   npm install

4. 開発サーバーを起動します:

   npm run dev

Docker デプロイメント

1. docker-compose を使用してビルドおよび実行します。

   docker-compose up --build

Coolify デプロイメント

1. Coolifyダッシュボードで新しいサービスを作成します

2. 「ソースからデプロイ」を選択する

3. 以下を設定します。

   • リポジトリ URL: リポジトリ URL

   • 支店: メイン

   • ビルドコマンド: npm run build

   • 起動コマンド: npm start

   • ポート: 3001

   • 環境変数:

     • BRAVE_API_KEY=APIキーを入力してください

     • ポート=3001

SSE統合の使用

SSEエンドポイント

SSEエンドポイントはリアルタイム検索結果を提供します。EventSource APIを使用して接続してください。

メッセージエンドポイント

このエンドポイントを使用して、接続されているすべての SSE クライアントにブロードキャストされる検索をトリガーします。

MCPの使用

サーバーは次の MCP ツールを提供します。

• brave_web_search : Brave Search APIを使用してウェブ検索を実行します

  { query: string; // Search query count?: number; // Number of results (1-20, default: 10) }

エラー処理

• サーバーは接続されたすべてのSSEクライアントにエラーをブロードキャストします。

• エラーの形式は次のようになります:

  { "type": "error", "error": "error message" }

注記

• SSE接続はクライアントが閉じるまで開いたままになります。

• 各検索結果は接続されているすべてのクライアントにブロードキャストされます

• サーバーは自動的に切断とクリーンアップを処理します

• 本番環境では、メッセージエンドポイントの認証を実装することを検討してください。