JinDaGe - mcp2brave MCP Details

article

README

🚀 MCP2Brave

MCP2Brave 是一个基于 MCP 协议的服务器，借助 Brave API 实现强大的网络搜索功能，为用户提供便捷的网络信息获取途径。

🚀 快速开始

MCP2Brave 能让你轻松利用 Brave API 进行网络搜索，以下是快速开启使用的步骤。

✨ 主要特性

基于 MCP 协议构建，稳定性高。
集成 Brave API，实现高效网络搜索。
提供多种工具函数，方便开发使用。

📦 安装指南

系统要求

Python 3.11+
UV 包管理器
Brave API 密钥

安装步骤

克隆项目

git clone <仓库地址>
cd mcp2brave

创建并编辑环境变量文件

# 添加Brave API密钥到.env文件
.env

使用 UV 创建虚拟环境

# 创建并激活虚拟环境
uv venv
# Windows系统使用:
.venv\Scripts\activate
# Linux/Mac系统使用:
source .venv/bin/activate

安装依赖

uv sync

💻 使用示例

安装为 Claude 扩展

fastmcp install mcp2brave.py

开发模式与 MCP 检查器

要使用 MCP 检查器测试功能：

fastmcp dev mcp2brave.py

运行后，可以在浏览器访问 MCP 检查器：http://localhost:5173

可用工具

search_web(query: str): 使用 Brave API 搜索网络
search_web_info(query: str): 同上，带中文描述

📚 详细文档

环境变量

| 属性 | 详情 | |------|------| | BRAVE_API_KEY | 你的 Brave API 密钥（必需） |

注意事项

⚠️ 重要提示

确保在使用前已正确设置 API 密钥。

虚拟环境激活后才能运行相关命令。

如遇到编码问题，请确保系统使用 UTF - 8 编码。

手动添加 Cline Continue Claude

打开 Cline Continue Claude 的 MCP 服务器配置文件，加入以下信息

"mcp2brave": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "--with",
        "python-dotenv",
        "--with",
        "beautifulsoup4",
        "--with",
        "requests",
        "fastmcp",
        "run",
        "C:\\Users\\你的真实路径\\mcp2brave.py"
      ],
      "env": {
        "BRAVE_API_KEY": "API密钥"
      }
    }

详细操作步骤

Cline 集成

使用示例

搜索示例

mcp2brave