🚀 勇敢搜索 MCP 服务器
本项目实现了一个适用于 Brave Search 的 Model Context Protocol (MCP) 服务器，可支持与像 Claude 这样的人工智能助手集成，为 AI 应用带来强大的搜索能力。
🚀 快速开始
此项目实现的 Brave Search MCP 服务器，可与 Claude 等人工智能助手集成，让你在使用 AI 时能调用 Brave Search 的搜索功能。
✨ 主要特性
- 实现适用于 Brave Search 的 MCP 服务器。
- 支持与 Claude 等人工智能助手集成。
- 提供
brave_web_search和brave_local_search两个主要工具。
📦 安装指南
先决条件
- Python 3.11+ 版本
- uv - 一个快速的 Python 包安装器和依赖项解析器
通过 Smithery 自动安装
要使用 Smithery 快速自动安装 Brave Search MCP 服务器以供 Claude 桌面版使用，可执行以下命令：
npx -y @smithery/cli install @arben-adm/brave-mcp-search --client claude
手动安装
- 克隆仓库：
git clone https://github.com/your-username/brave-search-mcp.git
cd brave-search-mcp
- 创建虚拟环境并使用 uv 安装依赖项：
uv venv
source .venv/bin/activate # 在 Windows 上，使用：.venv\Scripts\activate
uv pip install -r requirements.txt
- 设置你的 Brave Search API 密钥：
export BRAVE_API_KEY=your_api_key_here
在 Windows 上，使用：set BRAVE_API_KEY=your_api_key_here
💻 使用示例
基础用法
- 配置 MCP 设置文件（例如
claude_desktop_config.json），使其包含 Brave Search MCP 服务器：
{
"mcpServers": {
"brave-search": {
"command": "uv",
"args": [
"--directory",
"path-to\\mcp-python\\brave-mcp-search\\src",
"run",
"server.py"
],
"env": {
"BRAVE_API_KEY": "YOUR_BRAVE_API_KEY_HERE"
}
}
}
}
将 YOUR_BRAVE_API_KEY_HERE 替换为你的实际 Brave API 密钥。
2. 通过运行你的 MCP 兼容的人工智能助手并使用更新后的配置，启动 Brave Search MCP 服务器。
3. 服务器现在已启动并准备好接受来自 MCP 客户端的请求。
4. 现在你可以通过调用可用工具，在你的 MCP 兼容人工智能助手（如 Claude）中使用 Brave Search 功能。
📚 详细文档
可用工具
该服务器提供两个主要工具：
brave_web_search：使用 Brave Search API 进行网络搜索。brave_local_search：搜索本地企业和服务位置。 有关工具的详细信息，请参阅src/server.py中的工具文档字符串。
开发
要对项目进行更改：
- 根据需要修改
src目录中的代码。 - 更新
requirements.txt文件，如果添加或删除了依赖项：
uv pip freeze > requirements.txt
- 重新启动服务器以应用更改。
故障排除
如果你遇到任何问题：
- 确保你的 Brave API 密钥已正确设置。
- 检查所有依赖项是否已安装。
- 验证你使用的 Python 版本是否兼容。
- 如果对代码进行了更改，请确保重新启动服务器。
📄 许可证
此项目根据 MIT License 授权 - 有关详细信息，请参阅 LICENSE 文件。