Brave Search MCP 服务器

本项目实现了 Brave Search 的模型上下文协议 (MCP) 服务器，允许与 Claude 等 AI 助手集成。

前提条件

• Python 3.11+
• uv - 一个快速的 Python 包安装器和解析器

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Brave Search MCP 服务器：

npx -y @smithery/cli install @arben-adm/brave-mcp-search --client claude

手动安装

1. 克隆存储库：

   git clone https://github.com/your-username/brave-search-mcp.git
   cd brave-search-mcp
   

2. 创建一个虚拟环境并使用 uv 安装依赖项：

   uv venv
   source .venv/bin/activate  # 在 Windows 上，使用： .venv\Scripts\activate
   uv pip install -r requirements.txt
   

3. 设置您的 Brave Search API 密钥：

   export BRAVE_API_KEY=your_api_key_here
   

   在 Windows 上，使用： set BRAVE_API_KEY=your_api_key_here

用法

1. 配置您的 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 兼容 AI 助手来启动 Brave Search MCP 服务器。

3. 服务器现在将运行并准备好接受来自 MCP 客户端的请求。

4. 您现在可以通过调用可用的工具在您的 MCP 兼容 AI 助手（如 Claude）中使用 Brave Search 功能。

可用工具

服务器提供两个主要工具：

1. brave_web_search: 使用 Brave Search API 执行网络搜索。
2. brave_local_search: 搜索本地商家和地点。

有关详细用法信息，请参阅 src/server.py 中的工具文档字符串。

开发

要对项目进行更改：

1. 根据需要在 src 目录中修改代码。
2. 如果您添加或删除依赖项，请更新 requirements.txt 文件：

   uv pip freeze > requirements.txt
   

3. 重新启动服务器以应用更改。

故障排除

如果您遇到任何问题：

1. 确保您的 Brave API 密钥已正确设置。
2. 检查是否已安装所有依赖项。
3. 验证您是否正在使用兼容的 Python 版本。
4. 如果您更改了代码，请确保重新启动服务器。

许可证

本项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。