返回 MCP 目录
public公开dns本地运行

mcp2brave

一个基于MCP协议的服务器项目,通过集成Brave API实现网络搜索功能,可作为Claude扩展使用。

article

README

🚀 MCP2Brave

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

🚀 快速开始

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

✨ 主要特性

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

📦 安装指南

系统要求

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

安装步骤

  1. 克隆项目
git clone <仓库地址>
cd mcp2brave
  1. 创建并编辑环境变量文件
# 添加Brave API密钥到.env文件
.env
  1. 使用 UV 创建虚拟环境
# 创建并激活虚拟环境
uv venv
# Windows系统使用:
.venv\Scripts\activate
# Linux/Mac系统使用:
source .venv/bin/activate
  1. 安装依赖
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 集成

配置 配置 配置

使用示例

搜索示例

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端