Servidor MCP de Brave Search

Una implementación de servidor MCP que integra la API de Brave Search y proporciona capacidades de búsqueda web, búsqueda de puntos de interés locales, búsqueda de videos, búsqueda de imágenes y búsqueda de noticias.

Características

Búsqueda web : realice una búsqueda regular en la web
Búsqueda de imágenes : Busque imágenes en la web. Los resultados estarán disponibles como recurso.
Búsqueda de noticias : Busque noticias en la web
Búsqueda de videos : busca videos en la web
Búsqueda de puntos de interés locales : busque ubicaciones físicas locales, negocios, restaurantes, servicios, etc.

Herramientas

búsqueda web valiente
- Ejecutar búsquedas web utilizando la API de Brave
- Entradas:
  - query (cadena): El término que se buscará en Internet
  - count (número, opcional): la cantidad de resultados a devolver (máximo 20, valor predeterminado 10)
búsqueda de imágenes valientes
- Obtener imágenes de la web relevantes para la consulta
- Entradas:
  - query (cadena): El término para buscar imágenes de Internet
  - count (número, opcional): la cantidad de imágenes a devolver (máximo 3, predeterminado 1)
búsqueda de noticias valientes
- Busca noticias en la web
- Entradas:
  - query (cadena): El término para buscar en Internet artículos de noticias, temas de tendencia o eventos recientes
  - count (número, opcional): la cantidad de resultados a devolver (máximo 20, valor predeterminado 10)
búsqueda local valiente
- Busque negocios locales, servicios y puntos de interés
- REQUIERE suscripción al plan Pro API para obtener resultados de ubicación
- Vuelve a brave_web_search si no se encuentran resultados de ubicación
- Entradas:
  - query (cadena): término de búsqueda local
  - count (número, opcional): la cantidad de resultados a devolver (máximo 20, predeterminado 5)
búsqueda de videos valientes
- Busca vídeos en la web
- Entradas:
  - query : (cadena): El término para buscar videos
  - count : (número, opcional): la cantidad de videos a devolver (máximo 20, predeterminado 10)

Configuración

Obtener una clave API

Regístrese para obtener una cuenta de Brave Search API
Elija un plan (nivel gratuito disponible con 2000 consultas/mes)
Genere su clave API desde el panel de desarrollador

Uso con Claude Desktop

Estibador

Clonar el repositorio
Compilación de Docker

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

Agregue esto a su claude_desktop_config.json :

{
  "mcp-servers": {
    "brave-search": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BRAVE_API_KEY",
        "brave-search-mcp"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR API KEY HERE"
      }
    }
  }
}

NPX

Agregue esto a su claude_desktop_config.json :

{
  "mcp-servers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "brave-search-mcp"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR API KEY HERE"
      }
    }
  }
}

Uso con LibreChat

Añade esto a librechat.yaml

brave-search:
  command: sh
  args:
    - -c
    - BRAVE_API_KEY=API KEY npx -y brave-search-mcp

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Depuración

Clonar el repositorio
Instalar dependencias y compilarlo

npm install

Construir la aplicación

npm run build

Utilice la función Ejecutar y depurar de VS Code

⚠ No parece funcionar en Windows 10/11, pero funciona en WSL2

Utilice el iniciador de ejecución y depuración de VS Code con puntos de interrupción completamente funcionales en el código:

Localice y seleccione ejecutar depuración.
Seleccione la configuración denominada " MCP Server Launcher " en el menú desplegable.
Seleccione el botón Ejecutar/Depurar. Podemos depurar las distintas herramientas usando MCP Inspector y VS Code.

Configuración de depuración de VS Code

Para configurar la depuración local con puntos de interrupción:

Almacenar la clave API de Brave en VS Code
- Abra la paleta de comandos (Cmd/Ctrl + Shift + P).
- Preferences: Open User Settings (JSON) .
- Añade el siguiente fragmento:
{ "brave.search.api.key": "your-api-key-here" }
Crear o actualizar .vscode/launch.json :

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "MCP Server Launcher",
      "skipFiles": ["<node_internals>/**"],
      "program": "${workspaceFolder}/node_modules/@modelcontextprotocol/inspector/cli/build/cli.js",
      "outFiles": ["${workspaceFolder}/dist/**/*.js"],
      "env": {
        "BRAVE_API_KEY": "${config:brave.search.api.key}",
        "DEBUG": "true"
      },
      "args": ["dist/index.js"],
      "sourceMaps": true,
      "console": "integratedTerminal",
      "internalConsoleOptions": "neverOpen",
      "preLaunchTask": "npm: build:watch"
    },
    {
      "type": "node",
      "request": "attach",
      "name": "Attach to Debug Hook Process",
      "port": 9332,
      "skipFiles": ["<node_internals>/**"],
      "sourceMaps": true,
      "outFiles": ["${workspaceFolder}/dist/**/*.js"]
    },
    {
      "type": "node",
      "request": "attach",
      "name": "Attach to REPL Process",
      "port": 9333,
      "skipFiles": ["<node_internals>/**"],
      "sourceMaps": true,
      "outFiles": ["${workspaceFolder}/dist/**/*.js"]
    }
  ],
  "compounds": [
    {
      "name": "Attach to MCP Server",
      "configurations": ["Attach to Debug Hook Process", "Attach to REPL Process"]
    }
  ]
}

Crear .vscode/tasks.json :

{
  "version": "2.0.0",
  "tasks": [
    {
      "type": "npm",
      "script": "build:watch",
      "group": {
        "kind": "build",
        "isDefault": true
      },
      "problemMatcher": ["$tsc"]
    }
  ]
}

Descargo de responsabilidad

Esta biblioteca no está oficialmente asociada con Brave Software. Es una implementación externa de la API de búsqueda de Brave con un servidor MCP.

Licencia

Este proyecto está licenciado bajo la Licencia Pública General GNU v3.0 - consulte el archivo LICENCIA para obtener más detalles.

Brave Search MCP

Integrations