Brave Search MCP サーバー

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

前提条件

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

インストール

Smithery経由でインストール

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

手動インストール

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ファイルを参照してください。