Skip to main content
Glama
enesjakozh
arben-adm

Brave Search MCP Server

by arben-adm
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Brave Search MCP サーバー

鍛冶屋のバッジ

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

前提条件

  • Python 3.11以上

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

Related MCP server: Brave Search MCP Server

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の 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  # 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ファイルを参照してください。

Available Tools

2 tools

Tool Schema Changelog

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

  1. 2 tool updatesv1.0.0
    • First observedbrave_local_search
    • First observedbrave_web_search
Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3.2/5.0

Scored across 2 tools

Disambiguation5/5

The two tools have clearly distinct purposes: one is for local business/place searches and the other is for general web searches. The descriptions explicitly differentiate their domains (local vs. web), making it impossible to confuse them. Each tool serves a unique function within the search domain.

Naming Consistency5/5

Both tools follow a perfectly consistent naming pattern: 'brave_' prefix followed by descriptive snake_case (local_search, web_search). The naming convention is uniform across all tools, making them predictable and easy to understand. There are no deviations or mixed styles.

Tool Count3/5

With only 2 tools, the server feels somewhat thin for a search domain that could benefit from more specialized operations (e.g., image search, news search, autocomplete). While the two core search functions are covered, the limited tool count may restrict agent capabilities for broader search-related tasks. It's borderline minimal but functional.

Completeness4/5

The server covers the essential search operations (local and web) well, but there are minor gaps in the search surface. For instance, no tools for image search, news search, or search suggestions/autocomplete are included, which are common in search APIs. However, the core workflows are adequately supported, and agents can work around these omissions.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Brave Search MCP Server

    vinhphamai23
    A
    license
    Not graded
    quality
    D
    maintenance
    Integrates the Brave Search API to provide web and local search capabilities, including news, articles, and business information. It features smart fallbacks from local to web search and supports pagination and freshness controls.
    399 npm
    1
    GPL 3.0

  • Brave Search MCP Server

    thomasvan
    A
    license
    Not graded
    quality
    D
    maintenance
    Integrates the Brave Search API into AI assistants to enable web and local business search capabilities. This allows models to perform real-time information retrieval and locate places using the Model Context Protocol.
    1
    MIT

Appeared in Searches