Brave Search

Servidor MCP de Brave Search

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 paginación y controles de actualización
• Búsqueda local: encuentra negocios, restaurantes y servicios con información detallada
• Filtrado flexible: controla tipos de resultados, niveles de seguridad y actualización del contenido
• Alternativas inteligentes: la búsqueda local recurre automáticamente a la web cuando no se encuentran resultados

Herramientas

• brave_web_search

  • Ejecuta búsquedas web con paginación y filtrado
  • Entradas:
    • query (cadena): términos de búsqueda
    • count (número, opcional): resultados por página (máx. 20)
    • offset (número, opcional): desplazamiento de paginación (máx. 9)

• brave_local_search

  • Busca negocios y servicios locales
  • Entradas:
    • query (cadena): términos de búsqueda local
    • count (número, 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 API de Brave Search
2. Elige un plan (nivel gratuito disponible con 2,000 consultas/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, usa 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 hacer esto 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 de 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.