Skip to main content
Glama
enesjakozh
arben-adm

Brave Search MCP Server

by arben-adm
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Servidor MCP de Brave Search

insignia de herrería

Este proyecto implementa un servidor de Protocolo de Contexto de Modelo (MCP) para Brave Search, lo que permite la integración con asistentes de IA como Claude.

Prerrequisitos

  • Python 3.11+

  • uv - Un instalador y solucionador rápido de paquetes de Python

Related MCP server: Brave Search MCP Server

Instalación

Instalación mediante herrería

Para instalar automáticamente el servidor Brave Search MCP para Claude Desktop a través de Smithery :

npx -y @smithery/cli install @arben-adm/brave-mcp-search --client claude

Instalación manual

  1. Clonar el repositorio:

    git clone https://github.com/your-username/brave-search-mcp.git
cd brave-search-mcp

  2. Cree un entorno virtual e instale dependencias usando uv:

    uv venv
source .venv/bin/activate  # On Windows, use: .venv\Scripts\activate
uv pip install -r requirements.txt

  3. Configura tu clave API de Brave Search:

    export BRAVE_API_KEY=your_api_key_here

    En Windows, use: set BRAVE_API_KEY=your_api_key_here

Uso

  1. Configure su archivo de configuración MCP (por ejemplo, claude_desktop_config.json ) para incluir el servidor MCP de Brave Search:

    {
  "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"
      }
    }
  }
}

    Reemplace YOUR_BRAVE_API_KEY_HERE con su clave API de Brave real.

  2. Inicie el servidor MCP de Brave Search ejecutando su asistente de IA compatible con MCP con la configuración actualizada.

  3. El servidor ahora estará funcionando y listo para aceptar solicitudes de clientes MCP.

  4. Ahora puedes usar la funcionalidad Brave Search en tu asistente de IA compatible con MCP (como Claude) invocando las herramientas disponibles.

Herramientas disponibles

El servidor proporciona dos herramientas principales:

  1. brave_web_search : realiza una búsqueda web utilizando la API de búsqueda Brave.

  2. brave_local_search : busca negocios y lugares locales.

Consulte la documentación de la herramienta en src/server.py para obtener información detallada sobre su uso.

Desarrollo

Para realizar cambios en el proyecto:

  1. Modifique el código en el directorio src según sea necesario.

  2. Actualice el archivo requirements.txt si agrega o elimina dependencias:

    uv pip freeze > requirements.txt

  3. Reinicie el servidor para aplicar los cambios.

Solución de problemas

Si encuentra algún problema:

  1. Asegúrese de que su clave API de Brave esté configurada correctamente.

  2. Verifique que todas las dependencias estén instaladas.

  3. Verifique que esté utilizando una versión de Python compatible.

  4. Si realiza cambios en el código, asegúrese de reiniciar el servidor.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Available Tools

2 tools

Tool Schema Changelog

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

  1. 2 tool updatesv1.0.0
    • First observedbrave_local_search
    • First observedbrave_web_search
Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3.2/5.0

Scored across 2 tools

Disambiguation5/5

The two tools have clearly distinct purposes: one is for local business/place searches and the other is for general web searches. The descriptions explicitly differentiate their domains (local vs. web), making it impossible to confuse them. Each tool serves a unique function within the search domain.

Naming Consistency5/5

Both tools follow a perfectly consistent naming pattern: 'brave_' prefix followed by descriptive snake_case (local_search, web_search). The naming convention is uniform across all tools, making them predictable and easy to understand. There are no deviations or mixed styles.

Tool Count3/5

With only 2 tools, the server feels somewhat thin for a search domain that could benefit from more specialized operations (e.g., image search, news search, autocomplete). While the two core search functions are covered, the limited tool count may restrict agent capabilities for broader search-related tasks. It's borderline minimal but functional.

Completeness4/5

The server covers the essential search operations (local and web) well, but there are minor gaps in the search surface. For instance, no tools for image search, news search, or search suggestions/autocomplete are included, which are common in search APIs. However, the core workflows are adequately supported, and agents can work around these omissions.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Brave Search MCP Server

    vinhphamai23
    A
    license
    Not graded
    quality
    D
    maintenance
    Integrates the Brave Search API to provide web and local search capabilities, including news, articles, and business information. It features smart fallbacks from local to web search and supports pagination and freshness controls.
    399 npm
    1
    GPL 3.0

  • Brave Search MCP Server

    thomasvan
    A
    license
    Not graded
    quality
    D
    maintenance
    Integrates the Brave Search API into AI assistants to enable web and local business search capabilities. This allows models to perform real-time information retrieval and locate places using the Model Context Protocol.
    1
    MIT

Appeared in Searches