Brave Search MCP Server

本项目实现了一个用于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文件。