勇敢搜索 MCP 服务器

此项目实现了一个适用于 Brave Search 的 Model Context Protocol (MCP) 服务器，支持与像 Claude 这样的人工智能助手集成。

先决条件

• Python 3.11+ 版本
• uv - 一个快速的 Python 包安装器和依赖项解析器

安装

通过 Smithery 自动安装

要使用 Smithery 快速自动安装 Brave Search MCP 服务器以供 Claude 桌面版使用：

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 兼容的人工智能助手并使用更新后的配置，启动 Brave Search MCP 服务器。

3. 服务器现在已启动并准备好接受来自 MCP 客户端的请求。

4. 现在你可以通过调用可用工具，在你的 MCP 兼容人工智能助手（如 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 授权 - 有关详细信息，请参阅 LICENSE 文件。