项目简介

'mcp2brave' 是一个基于 Model Context Protocol (MCP) 的服务器，它利用 Brave API 提供强大的网络搜索和新闻搜索功能，旨在为大型语言模型 (LLM) 客户端提供实时的外部信息访问能力。

主要功能点

网络搜索: 提供工具使用 Brave 搜索引擎进行网页内容搜索，并返回搜索结果和摘要。
新闻搜索: 提供工具使用 Brave 新闻 API 进行新闻搜索，支持多国家和语言。
网页内容获取: 提供工具直接获取指定 URL 的网页内容。

安装步骤

克隆仓库:

git clone <仓库地址>
cd mcp2brave

创建并编辑 '.env' 文件，添加 Brave API 密钥：

BRAVE_API_KEY=你的API密钥

使用 UV 创建虚拟环境:

uv venv
# 激活虚拟环境 (Windows)
.venv\Scripts\activate
# 激活虚拟环境 (Linux/Mac)
source .venv/bin/activate

安装依赖:
```
uv sync
```

服务器配置

以下 JSON 配置信息用于 MCP 客户端（如 Cline Continue Claude）连接 'mcp2brave' 服务器。请将配置添加到 MCP 客户端的服务器配置文件中。

{
  "mcp2brave": {
    "command": "uv",
    "args": [
      "run",
      "--with",
      "fastmcp",
      "--with",
      "python-dotenv",
      "--with",
      "beautifulsoup4",
      "--with",
      "requests",
      "fastmcp",
      "run",
      "C:\\Users\\你的真实路径\\mcp2brave.py"  // 请替换为 mcp2brave.py 文件的实际路径，例如 /path/to/mcp2brave/mcp2brave.py
    ],
    "env": {
      "BRAVE_API_KEY": "API密钥" // 请替换为你的 Brave API 密钥，或者确保在 .env 文件中已正确配置
    }
  }
}

配置参数说明:

'command': 启动服务器的命令，这里使用 'uv run'，确保已安装 UV 包管理器。
'args': 传递给 'uv run' 的参数列表：
- '--with fastmcp': 确保 'fastmcp' 库可用。
- '--with python-dotenv': 确保 'python-dotenv' 库可用，用于加载环境变量。
- '--with beautifulsoup4': 确保 'beautifulsoup4' 库可用，用于HTML解析。
- '--with requests': 确保 'requests' 库可用，用于网络请求。
- 'fastmcp': 指定使用 'fastmcp' 运行器。
- 'run': 'fastmcp run' 子命令用于运行 MCP 服务器。
- 'C:\Users\你的真实路径\mcp2brave.py': 请务必替换为 'mcp2brave.py' 文件的实际绝对路径。 这是服务器脚本的路径。
'env': 环境变量配置：
- 'BRAVE_API_KEY': 请务必替换为你的 Brave API 密钥，或者确保在项目根目录的 '.env' 文件中已正确配置。 这是访问 Brave API 的凭证。

基本使用方法

安装并配置完成后，在支持 MCP 协议的 LLM 客户端中，你可以通过以下工具来使用 'mcp2brave' 服务器提供的功能：

'search_brave_with_summary(query: str)': 使用 Brave 搜索引擎搜索网络，返回包含摘要和搜索结果的信息。
'brave_search_summary(query: str)': 与 'search_brave_with_summary' 功能相同，提供网络搜索和摘要。
'get_url_content_direct(url: str)': 直接获取指定 URL 的网页内容，返回网页文本和元数据。
'url_content(url: str)': 与 'get_url_content_direct' 功能相同，获取网页内容。
'search_news(query: str)': 使用 Brave 新闻 API 搜索新闻，返回新闻标题、来源、日期和描述等信息。
'search_news_info(query: str)': 与 'search_news' 功能相同，提供新闻搜索功能。

在 LLM 应用中，你可以根据需要调用这些工具，例如让 LLM 回答用户问题时先使用 'search_brave_with_summary' 获取最新信息，或使用 'search_news' 了解最新的新闻报道。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息