Skip to main content
Glama
dodou

brave-search-mcp

by dodou

Servidor MCP de Brave Search en Railway

Este es un servicio HTTP de Brave Search MCP desplegado en Railway.

Método de despliegue

Método 1: Despliegue a través de GitHub (recomendado)

  1. Haz un Fork o sube este directorio a un repositorio de GitHub

  2. Inicia sesión en el Dashboard de Railway

  3. Haz clic en New Project → Deploy from GitHub repo

  4. Selecciona el repositorio que subiste

    • Railway detectará automáticamente el package.json y ejecutará npm start

    • Railway configurará automáticamente la variable de entorno PORT

Método 2: A través de Railway CLI

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

Related MCP server: Brave Search MCP Server

Variables de entorno

En el Dashboard de Railway es obligatorio configurar:

Nombre de la variable

Descripción

Ejemplo

BRAVE_API_KEY

Obligatorio Brave Search API Key

BSA-xxxxxxxxxx

No es necesario configurar PORT manualmente, Railway lo gestionará automáticamente.

Obtener una API Key de Brave

  1. Ve a Brave Search API y regístrate

  2. Selecciona el plan Search (adecuado para agentes de IA)

  3. Genera una API Key en el panel de desarrollador

Una vez completado el despliegue

Railway proporcionará un dominio https://xxx.up.railway.app.

La dirección del endpoint MCP es: https://xxx.up.railway.app/mcp

Prueba local:

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":{}}'

Añadir MCP en Hermes

Tras el despliegue, ejecuta:

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

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

De esta forma, Hermes podrá realizar búsquedas a través del servicio Brave Search MCP en Railway.

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
    399 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