Skip to main content
Glama
deenesjakoruzh
kwp-lab

Brave Search With Proxy

by kwp-lab
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
JavaScript
Remote

Brave Search MCP サーバー

オプションの HTTP プロキシ構成を備えた、Web およびローカル検索用の Brave Search API を活用する MCP サーバー。

このリポジトリは、モデルコンテキストプロトコルサーバーからフォークし、ネイティブfetch実装をライブラリnode-fetch-nativeに置き換えます。

サーバーは、 http_proxyおよびhttps_proxy環境変数が設定されている場合、デフォルトでそれらを使用してリクエストをプロキシサーバー経由でルーティングします。BRAVE_SEARCH_PROXY環境変数を設定することで、別のプロキシサーバーを使用することBRAVE_SEARCH_PROXYできます。

特徴

  • ウェブ検索: 一般的なクエリ、ニュース、記事、ページ区切りと鮮度コントロール付き

  • ローカル検索: 詳細な情報でビジネス、レストラン、サービスを検索

  • 柔軟なフィルタリング: 結果の種類、安全レベル、コンテンツの鮮度を制御

  • スマートフォールバック: ローカル検索では、結果が見つからない場合は自動的にウェブにフォールバックします。

Related MCP server: MCP2Brave

ツール

  • 勇敢なウェブ検索

    • ページネーションとフィルタリングを使用してウェブ検索を実行する

    • 入力:

      • query （文字列）: 検索用語

      • count （数値、オプション）: 1ページあたりの結果数（最大20件）

      • offset （数値、オプション）：ページ区切りのオフセット（最大9）

  • 勇敢なローカル検索

    • 地元のビジネスやサービスを検索する

    • 入力:

      • query （文字列）：ローカル検索用語

      • count (数値、オプション): 結果の数（最大20）

    • ローカル検索結果が見つからない場合は自動的にウェブ検索に戻ります

構成

APIキーの取得

  1. Brave Search APIアカウントにサインアップする

  2. プランを選択してください（無料プランは月間2,000クエリまでご利用いただけます）

  3. 開発者ダッシュボードからAPIキーを生成する

Claude Desktopでの使用

これをclaude_desktop_config.jsonに追加します:

ドッカー

{
  "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での使用

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

VS CodeでNPXを使ってインストールする VS Code Insiders で NPX を使用してインストールする

VS CodeでDockerを使ってインストールする VS Code Insiders で Docker を使用してインストールする

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

オプションとして、ワークスペース内の.vscode/mcp.jsonというファイルに追加することもできます。これにより、他のユーザーと設定を共有できるようになります。

.vscode/mcp.jsonファイルではmcpキーは必要ないことに注意してください。

ドッカー

{
  "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ファイルをご覧ください。

Available Tools

2 tools

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 2 tool updates
    • First observedbrave_local_search
    • First observedbrave_web_search
Install Server
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

TDQS

A4.3/5.0

Scored across 2 tools

Disambiguation5/5

The two tools have clearly distinct purposes: brave_local_search targets local businesses and physical locations with 'near me' queries, while brave_web_search handles general web searches for information, news, and online content. There is no overlap in functionality, as each tool is specialized for different query types and data sources, making it easy for an agent to choose the correct one based on the user's intent.

Naming Consistency5/5

Both tool names follow a consistent pattern: 'brave_' prefix followed by a descriptive term ('local_search' and 'web_search') using snake_case. This naming convention clearly indicates the server domain (Brave Search) and the specific search type, making the tools predictable and easy to understand without any deviations or mixed styles.

Tool Count3/5

With only 2 tools, the server feels thin for a search domain, as it might benefit from additional tools like image search, news search, or advanced filtering options. However, the tools cover the core local and web search functionalities adequately, so it's borderline but not severely lacking. A typical search server would have more tools to handle diverse query types and result formats.

Completeness4/5

The server covers the essential search operations for local and web queries, with each tool providing detailed capabilities like pagination, filtering, and fallback mechanisms. Minor gaps exist, such as no dedicated tools for image or video searches, but agents can work around this using the web search tool. The surface is reasonably complete for basic search needs without significant dead ends.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Brave Search MCP Server

    Shoofio
    A
    license
    Not graded
    quality
    F
    maintenance
    An MCP server that integrates the Brave Search API to provide both web and local search capabilities, with features like pagination, filtering, and smart fallbacks.
    15
    MIT

  • Brave Search MCP

    mikechao
    A
    license
    A
    quality
    D
    maintenance
    An MCP Server implementation that integrates the Brave Search API, providing, Web Search, Local Points of Interest Search, Image Search, Video Search, News Search and LLM Context Search capabilities
    5
    196
    125
    GPL 3.0