Skip to main content
Glama
dodou

brave-search-mcp

by dodou

Brave Search MCP Server auf Railway

Dies ist ein Brave Search MCP HTTP-Dienst, der auf Railway bereitgestellt wird.

Bereitstellungsmethode

Methode 1: Bereitstellung über GitHub (empfohlen)

  1. Forken oder laden Sie dieses Verzeichnis in ein GitHub-Repository hoch

  2. Melden Sie sich beim Railway Dashboard an

  3. Klicken Sie auf New Project → Deploy from GitHub repo

  4. Wählen Sie das von Ihnen hochgeladene Repository aus

    • Railway erkennt automatisch die package.json und führt npm start aus

    • Railway setzt automatisch die Umgebungsvariable PORT

Methode 2: Über Railway CLI

npm i -g @railway/cli
railway login
railway init
railway up

Related MCP server: Brave Search MCP Server

Umgebungsvariablen

Im Railway Dashboard muss Folgendes festgelegt werden:

Variablenname

Beschreibung

Beispiel

BRAVE_API_KEY

Erforderlich Brave Search API Key

BSA-xxxxxxxxxx

PORT muss nicht manuell festgelegt werden, Railway kümmert sich automatisch darum.

Brave API Key erhalten

  1. Besuchen Sie Brave Search API, um sich zu registrieren

  2. Wählen Sie den Search-Plan (geeignet für KI-Agenten)

  3. Generieren Sie den API Key im Entwickler-Dashboard

Nach der Bereitstellung

Railway stellt eine https://xxx.up.railway.app-Domain bereit.

Die MCP-Endpunktadresse lautet: https://xxx.up.railway.app/mcp

Lokaler Test:

curl -s -X POST https://xxx.up.railway.app/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

MCP in Hermes hinzufügen

Führen Sie nach der Bereitstellung Folgendes aus:

# 添加 MCP 服务器
hermes mcp add brave-search --url https://你的域名.up.railway.app

# 确认无认证需求(API Key 在服务端设置)

Auf diese Weise kann Hermes Suchen über den Brave Search MCP-Dienst auf Railway durchführen.

Available Tools

6 tools
brave_summarizerbrave_summarizerA
Retrieves AI-generated summaries of web search results using Brave's Summarizer API. This tool processes search results to create concise, coherent summaries of information gathered from multiple sources.

When to use:

- When you need a concise overview of complex topics from multiple sources
- For quick fact-checking or getting key points without reading full articles
- When providing users with summarized information that synthesizes various perspectives
- For research tasks requiring distilled information from web searches

Returns a text summary that consolidates information from the search results. Optional features include inline references to source URLs and additional entity information.

Requirements: Must first perform a web search using brave_web_search with summary=true parameter. Requires a Pro AI subscription to access the summarizer functionality.
ParametersJSON Schema
NameRequiredDescriptionDefault
keyYesThe key is equal to value of field key as part of the Summarizer response model.
entity_infoNoReturns extra entities info with the summary response.
inline_referencesNoAdds inline references to the summary response.

TDQS

A4.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With minimal annotations (only title and openWorldHint), the description carries the full burden. It states the tool 'retrieves' summaries, indicating a read-only operation. It mentions optional features and prerequisites. However, it does not discuss error handling or rate limits, but overall behavior is clear.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured with a clear opening sentence, bullet-pointed 'When to use' section, and a final paragraph covering requirements. Every sentence adds value; there is no fluff or repetition. It is appropriately sized for the tool's complexity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given three parameters and no output schema, the description covers purpose, prerequisites, optional features, and use cases adequately. It does not detail the output format beyond 'text summary', but that is sufficient for the tool's role as a summarizer.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so parameters are fully described in the schema. The description adds context beyond the schema: it explains that 'key' comes from a prior search result, and describes the optional booleans as enabling inline references and entity info. This adds meaningful guidance.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool retrieves AI-generated summaries via Brave's Summarizer API. It uses a specific verb ('retrieves') and resource ('summaries of web search results'), and distinguishes itself from sibling tools that perform other search types (image, local, news, video, web).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly lists when to use (e.g., 'when you need a concise overview') and provides requirements: must first call brave_web_search with summary=true and requires a Pro AI subscription. It also implies when not to use by contrasting with sibling tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

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

  1. 6 tool updatesv1.0.0
    • First observedbrave_image_search
    • First observedbrave_local_search
    • First observedbrave_news_search
    • First observedbrave_summarizer
    • First observedbrave_video_search
    • First observedbrave_web_search

TDQS

A4.2/5.0

Scored across 6 tools

Disambiguation5/5

Each tool serves a distinct search type (web, image, news, video, local, summarizer) with clear descriptions. No overlapping purposes.

Naming Consistency4/5

All tools follow 'brave_<type>_search' pattern except 'brave_summarizer', which omits '_search', causing a minor inconsistency.

Tool Count5/5

Six tools cover all major search verticals (web, image, news, video, local, summarizer) without being excessive or insufficient.

Completeness5/5

The tool set provides a comprehensive search surface for web, images, news, video, local, and summarization, with no obvious gaps for a search-focused MCP server.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • 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
    625 npm
    127
    GPL 3.0
  • A
    license
    A
    quality
    A
    maintenance
    An MCP implementation that integrates the Brave Search API, providing comprehensive search capabilities including web, local business, image, video, news searches, and AI-powered summarization.
    8
    22,441 npm
    1,491
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    Enables web search capabilities through the Brave Search API, including web search, local POI lookups, and rich search results retrieval for MCP-compatible clients.
    4
    8 npm
    MIT