Brave Search SSE

🚀 勇敢搜索 MCP サービス（SSE サポート付き）

このサービスは、勇敢搜索機能を提供し、サーバー送信イベント（SSE）を統合したモデルコンテキストプロトコル（MCP）サーバーです。Coolify にデプロイして、リアルタイム検索サービスとして利用できます。

✨ 主な機能

• Brave Search API を統合した MCP プロトコル
• SSE を通じたリアルタイム検索結果の提供
• Docker と Coolify へのデプロイをサポート
• TypeScript で実装
• Express.js の SSE エンドポイント

📦 インストール

前提条件

• 勇敢検索 API キー
• Node.js 18 以上のバージョン
• Docker（コンテナ化デプロイ用）
• Coolify インスタンス

ローカル開発

1. リポジトリをクローンします。
2. .env ファイルを作成し、あなたの Brave API キーを追加します。

   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
   • ブランチ：main
   • ビルドコマンド：npm run build
   • 起動コマンド：npm start
   • ポート：3001
   • 環境変数：
     • BRAVE_API_KEY=your_api_key_here
     • PORT=3001

💻 使用例

SSE 統合

SSE エンドポイント

GET http://あなたのサーバー:3001/sse

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

const eventSource = new EventSource('http://あなたのサーバー:3001/sse');

eventSource.onmessage = (event) => {
  const data = JSON.parse(event.data);
  // 検索結果を処理する
  console.log(data);
};

eventSource.onerror = (error) => {
  console.error('SSE エラー:', error);
  eventSource.close();
};

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

POST http://あなたのサーバー:3001/messages
Content-Type: application/json

{
  "query": "あなたの検索クエリ",
  "count": 10  // オプション、 デフォルト値：10、最大値：20
}

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

MCP 使用

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

• brave_web_search：Brave Search API を通じてウェブ検索を実行します。

  {
    query: string;    // 検索クエリ
    count?: number;   // 結果の数（1 - 20、 デフォルト値：10）
  }
  

🔧 技術詳細

エラー処理

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

  {
    "type": "error",
    "error": "エラーメッセージ"
  }
  

注意事項

• SSE 接続はクライアントが閉じるまで開いたままになります。
• 各検索結果はすべての接続されたクライアントにブロードキャストされます。
• サーバーは自動的に切断とクリーンアップを処理します。
• 本番環境では、メッセージエンドポイントに認証を実装することをおすすめします。