node8848/brave-mcp repository overview

⁠Brave Search MCP Server（多 Key 版）

官方 brave/brave-search-mcp-server⁠ 的二开分支，核心改进：

• 多 API Key 轮询：BRAVE_API_KEY 支持逗号分隔多个 Key，请求按轮询策略分摊到各 Key 上，吞吐量 ≈ 每 Key 限速 × Key 数量（官方版单 Key 仅约 1 RPS）。
• 429 自动切换：某个 Key 触发限流时自动换下一个 Key 重试，全部 Key 都限流才报错。
• HTTP Bearer 鉴权：可配置 MCP_SERVER_TOKEN，客户端需携带 Authorization: Bearer <token> 访问，解决官方 HTTP 端点无鉴权的问题。

功能保持与官方版一致：Web / Image / Video / News / Local / Place / Summarizer / LLM Context 搜索，支持 STDIO 与 Streamable HTTP 两种传输。

⁠快速开始（Docker）

docker run -p 8080:8080 \
  -e BRAVE_API_KEY=key1,key2,key3 \
  -e MCP_SERVER_TOKEN=your-server-token \
  -e BRAVE_MCP_TRANSPORT=http \
  -e BRAVE_MCP_HOST=0.0.0.0 \
  node8848/brave-mcp:latest

⁠环境变量

⁠客户端接入（Streamable HTTP）

{
  "mcpServers": {
    "brave-search": {
      "type": "http",
      "url": "http://<host>:8080/mcp",
      "headers": {
        "Authorization": "Bearer <MCP_SERVER_TOKEN>"
      }
    }
  }
}