基本能力
产品定位
mcp-brave-search 是一个集成了 Brave Search API 的 MCP 服务器实现，提供网页搜索和本地搜索功能。
核心功能
- Web Search: 支持通用查询、新闻、文章搜索，具有分页和新鲜度控制功能
- Local Search: 查找商家、餐厅和服务，提供详细信息
- Flexible Filtering: 控制结果类型、安全级别和内容新鲜度
- Smart Fallbacks: 本地搜索无结果时自动回退到网页搜索
适用场景
- 信息检索
- 本地服务查找
- 开发集成搜索功能
工具列表
- brave_web_search: 执行网页搜索，支持分页和过滤
- 输入参数:
query(string): 搜索词count(number, optional): 每页结果数（最多20）offset(number, optional): 分页偏移量（最多9）
- brave_local_search: 搜索本地商家和服务
- 输入参数:
query(string): 本地搜索词count(number, optional): 结果数量（最多20）
- 无本地结果时自动回退到网页搜索
常见问题解答
- 如何获取 API Key？
- 注册 Brave Search API 账户
- 选择计划（免费层每月提供 2,000 次查询）
- 从开发者仪表板生成 API key here
使用教程
使用依赖
需要先获取 Brave Search API Key
安装教程
Docker 安装
json
{
"mcpServers": {
"brave-search": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"BRAVE_API_KEY",
"mcp/brave-search"
],
"env": {
"BRAVE_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}
NPX 安装
json
{
"mcpServers": {
"brave-search": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-brave-search"
],
"env": {
"BRAVE_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}
调试方式
Docker 构建
bash
docker build -t mcp/brave-search:latest -f src/brave-search/Dockerfile .
