Brave Search MCP

🚀 勇敢搜索 MCP サーバー

このサーバーは Brave Search API を統合した MCP サーバーです。以下の機能をサポートしています。

• ウェブ検索：Brave Search を通じてウェブコンテンツの検索と取得を行います。
• ローカル地点検索（POI）：地図上で近くの興味のある場所（レストラン、ホテルなど）を検索します。
• ビデオ検索：YouTube や Twitch などのプラットフォームを通じてビデオコンテンツの検索と再生を行います。
• 画像検索：Google Images を通じて画像リソースの検索と閲覧を行います。
• ニュース検索：複数のニュースソースを集約し、リアルタイムのニュース情報を提供します。

✨ 主な機能

1. ウェブ検索 (brave_web_search)

{
  "id": "search#web",
  "name": "ウェブ検索",
  "description": "Brave Search を通じてウェブコンテンツの検索を実現します。",
  "parameters": [
    {
      "name": "query",
      "type": "string",
      "required": true,
      "description": "検索するコンテンツのキーワード。"
    },
    {
      "name": "count",
      "type": "number",
      "default": 10,
      "description": "返される結果の最大数（デフォルトは 10）。"
    }
  ]
}

2. ローカル地点検索 (brave_location_search)

{
  "id": "search#location",
  "name": "位置検索",
  "description": "地図上で近くの興味のある場所を検索します。",
  "parameters": [
    {
      "name": "latitude",
      "type": "number",
      "required": true,
      "description": "検索する緯度値。"
    },
    {
      "name": "longitude",
      "type": "number",
      "required": true,
      "description": "検索する経度値。"
    },
    {
      "name": "radius",
      "type": "number",
      "default": 5000,
      "description": "検索範囲（メートル単位、デフォルトは 5000 メートル）。"
    }
  ]
}

3. ビデオ検索 (brave_video_search)

{
  "id": "search#video",
  "name": "ビデオ検索",
  "description": "YouTube と Twitch を通じてビデオコンテンツの検索と再生を行います。",
  "parameters": [
    {
      "name": "query",
      "type": "string",
      "required": true,
      "description": "検索するビデオのキーワード。"
    },
    {
      "name": "platform",
      "type": "string",
      "default": "youtube",
      "description": "検索するプラットフォームを指定（youtube と twitch をサポート）。"
    }
  ]
}

4. 画像検索 (brave_image_search)

{
  "id": "search#image",
  "name": "画像検索",
  "description": "Google Images を通じて画像リソースの検索と閲覧を行います。",
  "parameters": [
    {
      "name": "query",
      "type": "string",
      "required": true,
      "description": "検索する画像のキーワード。"
    },
    {
      "name": "count",
      "type": "number",
      "default": 10,
      "description": "返される結果の最大数（デフォルトは 10）。"
    }
  ]
}

5. ニュース検索 (brave_news_search)

{
  "id": "search#news",
  "name": "ニュース検索",
  "description": "複数のニュースソースを集約し、リアルタイムのニュース情報を提供します。",
  "parameters": [
    {
      "name": "query",
      "type": "string",
      "required": true,
      "description": "検索するニュースのキーワード。"
    },
    {
      "name": "language",
      "type": "string",
      "default": "zh-CN",
      "description": "ニュースの言語バージョンを指定（デフォルトは簡体字中国語）。"
    }
  ]
}

📦 インストール

1. 依存関係のインストール：

   • Node.js と npm がインストールされていることを確認してください。
   • npm install を実行して、プロジェクトに必要な依存パッケージをインストールします。

2. 環境変数の設定

   • .env ファイルを作成し、以下の内容を追加します。

     API_KEY=your_api_key_here
     

3. サーバーの起動：

   • node index.js または npm start コマンドを実行して、MCP サービスを起動します。

4. インターフェースの呼び出し

   • http://localhost:3000/v1/search/{type} にリクエストを送信し、必要に応じて {type} を具体的な機能モジュール ID に置き換えます。
   • 例：curl http://localhost:3000/v1/search/web?q= Brave Search

⚠️ 注意事項

⚠️ 重要提示

プロジェクトでは合法で有効な API Key を設定してください。

⚠️ 重要提示

機密情報を処理する際には、暗号化と保護措置を行ってください。

⚠️ 重要提示

実際のニーズに応じてサーバー設定を調整し、サービスが安定して動作するようにしてください。

📁 プロジェクト構造

brave-search-mcp/
├── index.js          # メインプログラムのエントリーポイント
├── config/           # 設定フォルダ
│   └── keys.js      # API Key 管理
├── services/         # 各機能モジュールの実装
│   ├── webSearch.js  # ウェブ検索サービス
│   ├── location.js  # 位置検索サービス
│   ├── video.js     # ビデオ検索サービス
│   ├── image.js     # 画像検索サービス
│   └── news.js      # ニュース検索サービス
└── package.json      # プロジェクトの依存関係とスクリプトの設定

📄 ライセンス

• オープンソースライセンス：MIT License
• 著作権表示：著作権は原作者に帰属し、許可なく商用利用することは禁止されています。

💪 貢献ガイド

コミュニティからのコード貢献を歓迎します！問題を発見した場合や改善提案がある場合は、GitHub で Issues または Pull Request を提出してください。