Brave Search MCP Server

Brave Search MCP 服务器

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

先决条件

• Python 3.11+
• uv - 快速的 Python 软件包安装程序和解析器

安装

通过 Smithery 安装

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

手动安装

1. 克隆存储库：
   git clone https://github.com/your-username/brave-search-mcp.git cd brave-search-mcp
2. 使用 uv 创建虚拟环境并安装依赖项：
   uv venv source .venv/bin/activate # On Windows, use: .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" } } } }
   用您的实际 Brave API 密钥替换YOUR_BRAVE_API_KEY_HERE 。
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文件。