文档MCP 索引Brave 搜索

Brave 搜索

通过 Brave Search MCP 服务器为 Claude Code 添加实时网页搜索能力，获取最新的技术文档、API参考和解决方案。

功能特点

  • 实时搜索：获取最新的网络内容和技术资讯
  • 隐私保护：Brave Search 不跟踪用户搜索行为
  • 高质量结果：独立搜索索引，减少SEO操作影响
  • 开发友好：专门优化技术内容搜索

安装配置

1. 获取 Brave Search API 密钥

访问 Brave Search API 注册并获取免费的API密钥：

# 免费额度
- 每月 2,000 次查询
- 每分钟 5 次请求
- 无需信用卡
 
# 付费计划
- $5/月：15,000 次查询
- $15/月：50,000 次查询
- 更高并发限制

2. 安装 MCP 服务器

# 使用 npm 安装
npm install -g @brave/search-mcp-server
 
# 或使用 npx 直接运行
npx @brave/search-mcp-server

3. 配置 Claude Code

在 ~/.claude.json 中添加 MCP 服务器配置：

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["@brave/search-mcp-server"],
      "env": {
        "BRAVE_API_KEY": "your-brave-api-key-here"
      }
    }
  }
}

4. 验证连接

# 启动 Claude Code
claude
 
# 检查 MCP 连接状态
/mcp list
 
# 测试搜索功能
搜索最新的 React 18 性能优化技巧

使用示例

基础搜索查询

# 技术问题搜索
搜索 "Next.js 15 app router 性能优化"
 
# 错误信息搜索
搜索 "TypeError: Cannot read property of undefined React"
 
# 最新文档搜索
找到 TypeScript 5.3 的新特性文档

开发场景应用

查找解决方案

# 直接描述问题，Claude会自动搜索
我遇到了CORS错误，帮我找找最新的解决方案
 
# 具体技术栈问题
Express.js中如何正确处理文件上传，搜索最佳实践

获取最新信息

# 框架更新信息
Vue 3.4 有哪些新特性？搜索官方发布说明
 
# 安全漏洞信息
搜索 lodash 最近的安全漏洞报告

API 文档查找

# 官方文档搜索
搜索 GitHub Actions 的最新 API 文档
 
# 第三方库文档
查找 Prisma ORM 的查询优化指南

搜索优化技巧

关键词优化

# 好的搜索查询
"React useEffect dependency array" site:reactjs.org
"JavaScript memory leak debugging" filetype:pdf
"TypeScript generic constraints" -tutorial
 
# 避免的查询模式
"how to code"  # 太宽泛
"error"        # 缺乏上下文

搜索范围限定

# 限定网站搜索
搜索 site:stackoverflow.com "Next.js hydration error"
 
# 限定时间范围  
搜索最近一年的 "Vite 5 配置指南"
 
# 限定文件类型
搜索 filetype:md "API documentation"

💡 搜索策略：Claude Code 会根据你的问题自动构造最优的搜索查询，也可以明确指定搜索条件。

高级功能

搜索结果分析

# 自动分析和总结
搜索并分析 "React 18 并发特性" 的实现原理
 
# 对比不同方案
搜索并对比 "Vue vs React 2024" 的性能差异
 
# 最佳实践提取
从搜索结果中提取 "Node.js 部署" 的最佳实践

代码示例搜索

# 实际代码示例
搜索 "React custom hooks 实际应用示例"
 
# GitHub 代码搜索
在 GitHub 上搜索 "Next.js API routes middleware" 示例
 
# Stack Overflow 方案
搜索 Stack Overflow 上关于 "TypeScript 泛型" 的高分回答

配置优化

环境变量配置

# .env 文件
BRAVE_API_KEY=your-api-key
BRAVE_SEARCH_TIMEOUT=30000
BRAVE_MAX_RESULTS=10
 
# 系统环境变量  
export BRAVE_API_KEY="your-api-key"
export BRAVE_SEARCH_LANG="zh-CN"

高级配置选项

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["@brave/search-mcp-server"],
      "env": {
        "BRAVE_API_KEY": "your-api-key",
        "SEARCH_TIMEOUT": "30000",
        "MAX_RESULTS": "15",
        "SAFE_SEARCH": "moderate",
        "COUNTRY": "CN",
        "LANGUAGE": "zh"
      }
    }
  }
}

故障排查

常见问题

API密钥问题

# 错误：401 Unauthorized
# 解决：检查API密钥是否正确设置
echo $BRAVE_API_KEY
 
# 重新配置密钥
claude config set brave.api_key "new-api-key"

连接超时

# 错误：Search request timeout
# 解决：增加超时时间
export BRAVE_SEARCH_TIMEOUT=60000

配额超限

# 错误：429 Rate limit exceeded
# 解决：检查使用量或升级计划
# 查看当前用量：登录 Brave Search API 控制台

调试方法

# 启用详细日志
claude --verbose
 
# 检查 MCP 服务器状态
/mcp status brave-search
 
# 测试 API 连接
curl -H "X-Subscription-Token: your-api-key" \
     "https://api.search.brave.com/res/v1/web/search?q=test"

使用限制

API 配额管理

  • 免费层：每月2,000次查询，适合个人开发
  • 付费层：根据需要选择，支持更高频次使用
  • 并发限制：每分钟请求频次有限制

内容限制

  • 地理限制：某些地区可能有访问限制
  • 内容过滤：遵循 Brave Search 的内容政策
  • 商业用途：大规模商业使用需要适当的付费计划

替代方案

如果 Brave Search 不可用，可以考虑：

  • Google Custom Search API：需要配置自定义搜索引擎
  • Bing Web Search API：Microsoft 提供的搜索服务
  • DuckDuckGo Instant Answer API：隐私友好的搜索选项
  • SearchApi：第三方搜索聚合服务

相关服务器

参考资源

MCP 概览Actions 概览
关于我