Brave Search MCP Server

Brave Search MCP サーバー

Brave Search API を利用してウェブ検索とローカル検索を行い、HTTP プロキシ設定にも対応する MCP サーバーです。

このリポジトリはModel Context Protocol サーバーをフォークし、ネイティブの fetch 実装をライブラリ node-fetch-native に置き換えています。

http_proxy と https_proxy 環境変数が設定されている場合、サーバーはデフォルトでこれらの環境変数を使って、プロキシサーバー経由でリクエストを送信します。 別のプロキシサーバーを使用するには、BRAVE_SEARCH_PROXY 環境変数を設定することもできます。

機能

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

ツール

• brave_web_search

  • ページネーションやフィルタリングに対応したウェブ検索を実行
  • 入力：
    • query（文字列）：検索語
    • count（数値、任意）：ページあたりの結果数（最大 20）
    • offset（数値、任意）：ページネーションのオフセット（最大 9）

• brave_local_search

  • ローカルのビジネスやサービスを検索
  • 入力：
    • query（文字列）：ローカル検索語
    • count（数値、任意）：結果数（最大 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",
        "BRAVE_SEARCH_PROXY": "https://example.com:10890" // Optional, remove if not needed
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@kwp-lab/mcp-brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE",
        "BRAVE_SEARCH_PROXY": "https://example.com:10890" // Optional, remove if not needed
      }
    }
  }
}

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}",
          "BRAVE_SEARCH_PROXY": "https://example.com:10890" // Optional, remove if not needed
        }
      }
    }
  }
}

NPX

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "brave_api_key",
        "description": "Brave Search API Key",
        "password": true
      }
    ],
    "servers": {
      "brave-search": {
        "command": "npx",
        "args": ["-y", "@kwp-lab/mcp-brave-search"],
        "env": {
          "BRAVE_API_KEY": "${input:brave_api_key}",
          "BRAVE_SEARCH_PROXY": "https://example.com:10890" // Optional, remove if not needed
        }
      }
    }
  }
}

ビルド

Docker のビルド：

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

ライセンス

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