Brave MCP Search

🚀 勇敢搜索 MCP 服务器

本项目实现了一个适用于 Brave Search 的 Model Context Protocol (MCP) 服务器，可支持与像 Claude 这样的人工智能助手集成，为 AI 应用带来强大的搜索能力。

🚀 快速开始

此项目实现的 Brave Search MCP 服务器，可与 Claude 等人工智能助手集成，让你在使用 AI 时能调用 Brave Search 的搜索功能。

✨ 主要特性

• 实现适用于 Brave Search 的 MCP 服务器。
• 支持与 Claude 等人工智能助手集成。
• 提供 brave_web_search 和 brave_local_search 两个主要工具。

📦 安装指南

先决条件

• 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 文件。