Brave Search MCP サーバー

このプロジェクトは、Brave Search 用の Model Context Protocol (MCP) サーバーを実装し、Claude などの AI アシスタントとの統合を可能にします。

前提条件

• Python 3.11以上

• uv - 高速なPythonパッケージインストーラーとリゾルバー

Related MCP server: Brave Search MCP Server

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Brave Search MCP サーバーを自動的にインストールするには:

npx -y @smithery/cli install @arben-adm/brave-mcp-search --client claude

手動インストール

1. リポジトリをクローンします。

   git clone https://github.com/your-username/brave-search-mcp.git
   cd brave-search-mcp

2. 仮想環境を作成し、uv を使用して依存関係をインストールします。

   uv venv
   source .venv/bin/activate  # On Windows, use: .venv\Scripts\activate
   uv pip install -r requirements.txt

3. Brave Search API キーを設定します。

   export BRAVE_API_KEY=your_api_key_here

   Windowsでは、 set BRAVE_API_KEY=your_api_key_hereを使用します。

使用法

1. MCP 設定ファイル (例: claude_desktop_config.json ) を構成して、Brave Search MCP サーバーを含めます。

   {
     "mcpServers": {
       "brave-search": {
         "command": "uv",
         "args": [
           "--directory",
           "path-to\\mcp-python\\brave-mcp-search\\src",
           "run",
           "server.py"
         ],
         "env": {
           "BRAVE_API_KEY": "YOUR_BRAVE_API_KEY_HERE"
         }
       }
     }
   }

   YOUR_BRAVE_API_KEY_HEREを実際の Brave API キーに置き換えます。

2. 更新された構成で MCP 互換の AI アシスタントを実行して、Brave Search MCP サーバーを起動します。

3. サーバーは実行され、MCP クライアントからの要求を受け入れる準備が整いました。

4. 利用可能なツールを呼び出すことで、MCP 対応の AI アシスタント (Claude など) で Brave Search 機能を使用できるようになりました。

利用可能なツール

サーバーは主に 2 つのツールを提供します。

1. brave_web_search : Brave Search API を使用して Web 検索を実行します。

2. brave_local_search : 地元の企業や場所を検索します。

詳細な使用方法については、 src/server.pyのツールのドキュメント文字列を参照してください。

発達

プロジェクトに変更を加えるには:

1. 必要に応じてsrcディレクトリ内のコードを変更します。

2. 依存関係を追加または削除する場合は、 requirements.txtファイルを更新します。

   uv pip freeze > requirements.txt

3. 変更を適用するにはサーバーを再起動します。

トラブルシューティング

問題が発生した場合:

1. Brave API キーが正しく設定されていることを確認してください。

2. すべての依存関係がインストールされていることを確認します。

3. 互換性のある Python バージョンを使用していることを確認してください。

4. コードを変更した場合は、必ずサーバーを再起動してください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。