Skip to main content
Glama
dodou

brave-search-mcp

by dodou

Brave Search MCP Server on Railway

这是一个部署在 Railway 上的 Brave Search MCP HTTP 服务。

部署方式

方式 1:通过 GitHub 部署(推荐)

  1. Fork 或上传此目录到 GitHub 仓库

  2. 登录 Railway Dashboard

  3. 点击 New Project → Deploy from GitHub repo

  4. 选择你上传的仓库

    • Railway 会自动识别 package.json 并运行 npm start

    • Railway 会自动设置 PORT 环境变量

方式 2:通过 Railway CLI

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

Related MCP server: Brave Search MCP Server

环境变量

在 Railway Dashboard 中 必须设置:

变量名

说明

示例

BRAVE_API_KEY

必需 Brave Search API Key

BSA-xxxxxxxxxx

不需要手动设置 PORT,Railway 会自动处理。

获取 Brave API Key

  1. 前往 Brave Search API 注册

  2. 选择 Search 计划(适合 AI Agents)

  3. 在 开发者面板 生成 API Key

部署完成后

Railway 会提供一个 https://xxx.up.railway.app 域名。

MCP 端点地址为:https://xxx.up.railway.app/mcp

本地测试:

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

在 Hermes 中添加 MCP

部署后运行:

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

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

这样 Hermes 就能通过 Railway 上的 Brave Search MCP 服务进行搜索了。

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