Brave Search MCP 服务器

该项目实现了用于 Brave 搜索的模型上下文协议 (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 搜索 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 搜索 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 搜索 MCP 服务器。

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

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

可用工具

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

1. brave_web_search：使用 Brave 搜索 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 文件以获取详细信息。