Skip to main content
Glama
mikechao

Brave Search MCP

by mikechao

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.

Related MCP server: Brave Search With Proxy

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

  1. Regístrese para obtener una cuenta de Brave Search API

  2. Elija un plan (nivel gratuito disponible con 2000 consultas/mes)

  3. Genere su clave API desde el panel de desarrollador

Uso con Claude Desktop

Estibador

  1. Clonar el repositorio

  2. Compilación de Docker

docker build -t brave-search-mcp:latest -f ./Dockerfile .
  1. 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

  1. Clonar el repositorio

  2. Instalar dependencias y compilarlo

npm install
  1. 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:

  1. Localice y seleccione ejecutar depuración.

  2. Seleccione la configuración denominada " MCP Server Launcher " en el menú desplegable.

  3. 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:

  1. 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"
    }
  2. 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"]
    }
  ]
}
  1. 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.

Available Tools

5 tools

Tool Schema Changelog

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

  1. 5 tool updatesv1.0.0
    • First observedbrave_image_search
    • First observedbrave_local_search
    • First observedbrave_news_search
    • First observedbrave_video_search
    • First observedbrave_web_search

TDQS

A4/5.0

Scored across 5 tools

Disambiguation5/5

Each tool has a clearly distinct purpose targeting different content types: images, local businesses, news articles, videos, and general web content. The descriptions explicitly differentiate use cases (e.g., 'near me' for local search, 'recent events' for news), eliminating any ambiguity between tools.

Naming Consistency5/5

All tool names follow a consistent 'brave_[content_type]_search' pattern, using snake_case uniformly. This predictable naming scheme makes it easy to identify the tool's function and ensures no confusion from mixed conventions.

Tool Count5/5

With 5 tools, this server is well-scoped for its purpose of providing specialized search capabilities across different content types. Each tool earns its place by covering distinct search domains, avoiding both redundancy and excessive fragmentation.

Completeness5/5

The tool set comprehensively covers the search domain by addressing all major content types: images, local information, news, videos, and general web content. There are no obvious gaps, as agents can handle any search query by selecting the appropriate specialized or general tool.

Maintenance

ActivityInactive
ResponsivenessUnresponsive

Related MCP Connectors

Related MCP Servers