brave/brave-search-mcp-server

Developer tools 公式

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

1549 stars 224 forks 品質 90 トレンド 48MIT

Repository Install

Brave Search APIを統合したMCPサーバー実装で、ウェブ検索、ローカルビジネス検索、場所検索、画像検索、ビデオ検索などの包括的な検索機能を提供します,...

概要

Brave Search APIを統合したMCPサーバー実装で、ウェブ検索、ローカルビジネス検索、場所検索、画像検索、動画検索、ニュース検索、LLMコンテキスト、AI駆動の要約などの包括的な検索機能を提供します。このプロジェクトはSTDIOとHTTPの両方のトランスポートをサポートし、STDIOをデフォルトモードとしています。確立されたMCPの慣例に従い、サーバーは現在STDIOをデフォルトで設定します。HTTPを使い続けたい場合は、BRAVE_MCP_TRANSPORT環境変数をHTTPに設定するか、サーバー起動時にランタイム引数--transport httpを指定する必要があります。 MCPサーバーのバージョン1.xでは、base64でエンコードされた画像データと画像URLが返されるようになりました。これによりレスポンスが大幅に遅くなり、セッション内のコンテキストが不必要に消費されました。バージョン2.xではbase64エンコードされたデータが削除され、元のBrave Search APIレスポンスにより近いレスポンスオブジェクトが返されます。

概要（AI 翻訳）

移住

1.x から 2.x へ

デフォルト転送、STDIO

確立されたMCPの慣例に従うため、サーバーは現在STDIOをデフォルトで設定します。HTTPを継続したい場合は、BRAVE_MCP_TRANSPORT環境変数をhttpに設定するか、サーバー起動時にランタイム引数--transport httpを指定する必要があります。

`brave_image_search` の応答構造

MCPサーバーのバージョン1.xでは、base64でエンコードされた画像データと画像URLが返されます。これにより応答が大幅に遅くなり、セッション内のコンテキストが不必要に消費されました。バージョン2.xではbase64でエンコードされたデータが削除され、元のBrave Search API応答により近い応答オブジェクトが返されます。更新された出力スキーマはsrc/tools/images/schemas/output.tsで定義されています。

道具

ウェブ検索(`brave_web_search`)

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Brave Search MCP Server

An MCP server implementation that integrates the Brave Search API, providing comprehensive search capabilities including web search, local business search, place search, image search, video search, news search, LLM context, and AI-powered summarization. This project supports both STDIO and HTTP transports, with STDIO as the default mode.

Migration

1.x to 2.x

Default transport now STDIO

To follow established MCP conventions, the server now defaults to STDIO. If you would like to continue using HTTP, you will need to set the BRAVE_MCP_TRANSPORT environment variable to http, or provide the runtime argument --transport http when launching the server.

Response structure of `brave_image_search`

Version 1.x of the MCP server would return base64-encoded image data along with image URLs. This dramatically slowed down the response, as well as consumed unnecessarily context in the session. Version 2.x removes the base64-encoded data, and returns a response object that more closely reflects the original Brave Search API response. The updated output schema is defined in src/tools/images/schemas/output.ts.

Tools

Web Search (`brave_web_search`)

Performs comprehensive web searches with rich result types and advanced filtering options.

Parameters:

query (string, required): Search terms (max 400 chars, 50 words)
country (string, optional): Country code (default: “US”)
search_lang (string, optional): Search language (default: “en”)
ui_lang (string, optional): UI language (default: “en-US”)
count (number, optional): Results per page (1-20, default: 10)
offset (number, optional): Pagination offset (max 9, default: 0)
safesearch (string, optional): Content filtering (“off”, “moderate”, “strict”, default: “moderate”)
freshness (string, optional): Time filter (“pd”, “pw”, “pm”, “py”, or date range)
text_decorations (boolean, optional): Include highlighting markers (default: true)
spellcheck (boolean, optional): Enable spell checking (default: true)
result_filter (array, optional): Filter result types (default: [“web”, “query”])
goggles (array, optional): Custom re-ranking definitions
units (string, optional): Measurement units (“metric” or “imperial”)
extra_snippets (boolean, optional): Get additional excerpts (Pro plans only)
summary (boolean, optional): Enable summary key generation for AI summarization

Local Search (`brave_local_search`)

Searches for local businesses and places with detailed information including ratings, hours, and AI-generated descriptions.

Parameters:

Same as brave_web_search with automatic location filtering
Automatically includes “web” and “locations” in result_filter

GitHub で README 全文を見る

インストール

docker run -i --rm -e BRAVE_API_KEY docker.io/mcp/brave-search

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

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