Brave Search MCP Server

Brave Search MCP サーバー

Brave Search API と統合し、ウェブ検索とローカル検索の両方に対応する MCP サーバーの実装です。

機能

• ウェブ検索：ページネーションと鮮度の指定に対応した、一般的なクエリ、ニュース、記事の検索
• ローカル検索：詳細情報付きで、ビジネス、レストラン、サービスを検索
• 柔軟なフィルタリング：結果の種類、安全性のレベル、コンテンツの鮮度を指定
• スマートなフォールバック：ローカル検索で結果が見つからない場合、自動的にウェブ検索に切り替え

ツール

• brave_web_search

  • ページネーションとフィルタリングに対応したウェブ検索を実行
  • 入力：
    • query (string)：検索語
    • count (number, optional)：1ページあたりの結果数（最大20）
    • offset (number, optional)：ページネーションのオフセット（最大9）

• brave_local_search

  • ローカルのビジネスやサービスを検索
  • 入力：
    • query (string)：ローカル検索の検索語
    • count (number, optional)：結果数（最大20）
  • ローカル検索で結果が見つからない場合は、自動的にウェブ検索に切り替え

設定

API キーの取得

1. Brave Search API アカウントに登録します
2. プランを選択します（月間2,000クエリまで利用できる無料プランがあります）
3. 開発者ダッシュボードから API キーを生成します

Claude Desktop での使用

以下を claude_desktop_config.json に追加します：

Docker

{
  "mcpServers": {
    "brave-search": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BRAVE_API_KEY",
        "mcp/brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

VS Code での使用方法

すばやくインストールするには、以下のワンクリックインストールボタンを使用してください……

手動でインストールするには、以下の JSON ブロックを VS Code のユーザー設定（JSON）ファイルに追加してください。Ctrl + Shift + P を押して Preferences: Open User Settings (JSON) と入力すると追加できます。

必要に応じて、ワークスペース内の .vscode/mcp.json というファイルに追加することもできます。これにより、設定をほかのユーザーと共有できます。

.vscode/mcp.json ファイルでは、mcp キーは不要です。

Docker

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "brave_api_key",
        "description": "Brave Search API Key",
        "password": true
      }
    ],
    "servers": {
      "brave-search": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "BRAVE_API_KEY",
          "mcp/brave-search"
        ],
        "env": {
          "BRAVE_API_KEY": "${input:brave_api_key}"
        }
      }
    }
  }
}

NPX

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "brave_api_key",
        "description": "Brave Search API Key",
        "password": true
      }
    ],
    "servers": {
      "brave-search": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-brave-search"],
        "env": {
          "BRAVE_API_KEY": "${input:brave_api_key}"
        }
      }
    }
  }
}

ビルド

Docker のビルド：

docker build -t mcp/brave-search:latest -f src/brave-search/Dockerfile .

ライセンス

この MCP サーバーは MIT ライセンスの下でライセンスされています。MIT ライセンスの利用規約に従うことを条件に、ソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリの LICENSE ファイルをご覧ください。