Skip to main content
Glama

mcp2brave

一个基于MCP协议的服务器,使用Brave API实现网络搜索功能。

系统要求

  • Python 3.11+

  • UV包管理器

  • Brave API密钥

Related MCP server: Python Docs Server

安装步骤

  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集成

配置

Cline集成

配置

Cline集成

配置

使用示例

搜索示例

Available Tools

6 tools
brave_search_summaryC

使用Brave搜索引擎搜索网络信息

Inputs: query (required).

get_url_content_directC

Get webpage content directly using HTTP request

Args:
    url (str): The URL to fetch content from
    
Returns:
    str: The webpage content and metadata

Inputs: url (required).

search_brave_with_summaryC

Search the web using Brave Search API

Inputs: query (required).

search_newsC

Search news using Brave News API

Args:
    query (str): The search query for news
    
Returns:
    str: News search results including titles, sources, dates and descriptions

Inputs: query (required).

search_news_infoC

使用Brave新闻API搜索新闻

参数:
    query (str): 新闻搜索关键词
    
返回:
    str: 新闻搜索结果,包含标题、来源、日期和描述

Inputs: query (required).

url_contentC

直接获取网页内容

参数:
    url (str): 目标网页地址
    
返回:
    str: 网页内容和元数据

Inputs: url (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.6/5.0

    Scored across 6 tools

    Disambiguation2/5

    Multiple tools have unclear boundaries and overlapping purposes. 'brave_search_summary' and 'search_brave_with_summary' appear to serve the same function with only minor wording differences. Similarly, 'get_url_content_direct' and 'url_content' are essentially duplicates with one in English and one in Chinese. This creates significant ambiguity for agent selection.

    Naming Consistency2/5

    The naming conventions are inconsistent and chaotic. There's a mix of snake_case ('brave_search_summary') and lowercase with underscores ('search_brave_with_summary'), plus inconsistent verb usage ('get_' vs just the noun 'url_content'). The bilingual naming (English and Chinese) further compounds the inconsistency with no discernible pattern.

    Tool Count3/5

    With 6 tools, the count is reasonable for a search/content retrieval server. However, since 4 of these tools are essentially duplicates (2 search pairs and 2 URL content pairs), the effective tool count is much lower, making the server feel thin despite the nominal count being appropriate.

    Completeness3/5

    The server covers basic search and content retrieval operations, but there are notable gaps. While it provides search (general and news) and URL fetching, there's no way to filter search results, handle pagination, or access more advanced Brave Search features. The duplication of tools doesn't add functional coverage, leaving the surface incomplete for robust web interaction.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that integrates the Brave Search API to provide both web and local search capabilities, with features like pagination, filtering, and smart fallbacks.
      16
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP Server implementation that integrates the Brave Search API, providing, Web Search, Local Points of Interest Search, Image Search, Video Search, News Search and LLM Context Search capabilities
      5
      828 npm
      131
      GPL 3.0