Brave MCP Search

🚀 勇敢搜索 MCP サーバー

このプロジェクトは、Brave Search 用の Model Context Protocol (MCP) サーバーを実装しており、Claude などの人工知能アシスタントとの統合をサポートしています。

🚀 クイックスタート

このサーバーを使用することで、Brave Search を Claude などの人工知能アシスタントと統合でき、より高度な情報検索が可能になります。

✨ 主な機能

• Brave Search 用の MCP サーバーを提供します。
• Claude などの人工知能アシスタントとの統合をサポートします。
• ウェブ検索とローカル検索の 2 つの主要なツールを提供します。

📦 インストール

前提条件

• Python 3.11 以上のバージョン
• uv - 高速な Python パッケージインストーラーと依存関係解決ツール

Smithery を使用した自動インストール

Smithery を使用して、Claude デスクトップ版用の 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  # Windows の場合は、.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 互換の人工知能アシスタントを起動し、更新された設定を使用して Brave Search MCP サーバーを起動します。
3. サーバーが起動し、MCP クライアントからのリクエストを受け付ける準備ができました。
4. MCP 互換の人工知能アシスタント（例：Claude）で、利用可能なツールを呼び出すことで、Brave Search 機能を使用できます。

高度な使用法

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

• brave_web_search：Brave Search API を使用してウェブ検索を行います。
• 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 の下でライセンスされています。詳細については、LICENSE ファイルを参照してください。