Brave Search

Brave Search MCP Server

Una implementación de servidor MCP que integra la API de Brave Search, proporcionando capacidades de búsqueda web y local.

Características

• Búsqueda web: Consultas generales, noticias, artículos, con controles de paginación y actualización
• Búsqueda local: Encuentra negocios, restaurantes y servicios con información detallada
• Filtrado flexible: Controla los tipos de resultados, los niveles de seguridad y la actualización del contenido
• Alternativas inteligentes: La búsqueda local recurre automáticamente a la búsqueda web cuando no se encuentran resultados

Herramientas

• brave_web_search

  • Ejecuta búsquedas web con paginación y filtrado
  • Entradas:
    • query (string): Términos de búsqueda
    • count (number, opcional): Resultados por página (máx. 20)
    • offset (number, opcional): Desplazamiento de paginación (máx. 9)

• brave_local_search

  • Busca negocios y servicios locales
  • Entradas:
    • query (string): Términos de búsqueda local
    • count (number, opcional): Número de resultados (máx. 20)
  • Recurre automáticamente a la búsqueda web si no se encuentran resultados locales

Configuración

Obtención de una clave de API

1. Regístrate para obtener una cuenta de Brave Search API
2. Elige un plan (el nivel gratuito está disponible con 2,000 consultas al mes)
3. Genera tu clave de API desde el panel de desarrollador

Uso con Claude Desktop

Añade esto a tu claude_desktop_config.json:

Docker

{
  "mcpServers": {
    "brave-search": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BRAVE_API_KEY",
        "mcp/brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Uso con VS Code

Para una instalación rápida, utiliza los botones de instalación con un clic a continuación...

Para la instalación manual, añade el siguiente bloque JSON a tu archivo de Configuración de Usuario (JSON) en VS Code. Puedes hacerlo presionando Ctrl + Shift + P y escribiendo Preferences: Open User Settings (JSON).

Opcionalmente, puedes añadirlo a un archivo llamado .vscode/mcp.json en tu espacio de trabajo. Esto te permitirá compartir la configuración con otros.

Ten en cuenta que la clave mcp no es necesaria en el archivo .vscode/mcp.json.

Docker

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "brave_api_key",
        "description": "Brave Search API Key",
        "password": true
      }
    ],
    "servers": {
      "brave-search": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "BRAVE_API_KEY",
          "mcp/brave-search"
        ],
        "env": {
          "BRAVE_API_KEY": "${input:brave_api_key}"
        }
      }
    }
  }
}

NPX

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "brave_api_key",
        "description": "Brave Search API Key",
        "password": true
      }
    ],
    "servers": {
      "brave-search": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-brave-search"],
        "env": {
          "BRAVE_API_KEY": "${input:brave_api_key}"
        }
      }
    }
  }
}

Compilación

Compilación con Docker:

docker build -t mcp/brave-search:latest -f src/brave-search/Dockerfile .

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que eres libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulta el archivo LICENSE en el repositorio del proyecto.