Skip to main content
Glama
deenesjakoruzh
kwp-lab

Brave Search With Proxy

by kwp-lab
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
JavaScript
Remote

Servidor MCP de Brave Search

Un servidor MCP que aprovecha la API de Brave Search para búsqueda web y local, con configuración de proxy HTTP opcional.

Este repositorio se bifurca de los servidores del Protocolo de Contexto de Modelo y reemplaza la implementación fetch nativa con la biblioteca node-fetch-native .

El servidor usará las variables de entorno http_proxy y https_proxy para enrutar las solicitudes a través del servidor proxy de forma predeterminada, si están configuradas. También puede configurar la variable de entorno BRAVE_SEARCH_PROXY para usar un servidor proxy diferente.

Características

  • Búsqueda web : consultas generales, noticias, artículos, con controles de paginación y actualización

  • Búsqueda local : encuentre negocios, restaurantes y servicios con información detallada

  • Filtrado flexible : controle los tipos de resultados, los niveles de seguridad y la frescura del contenido

  • Retrocesos inteligentes : la búsqueda local regresa automáticamente a la web cuando no se encuentran resultados

Related MCP server: MCP2Brave

Herramientas

  • búsqueda web valiente

    • Ejecutar 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áximo 20)

      • offset (número, opcional): desplazamiento de paginación (máximo 9)

  • búsqueda local valiente

    • Busque empresas y servicios locales

    • Entradas:

      • query (cadena): Términos de búsqueda locales

      • count (número, opcional): Número de resultados (máximo 20)

    • Recurre automáticamente a la búsqueda web si no se encuentran resultados locales

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

Agregue esto a su claude_desktop_config.json :

Estibador

{
  "mcpServers": {
    "brave-search": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BRAVE_API_KEY",
        "mcp/brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE",
        "BRAVE_SEARCH_PROXY": "https://example.com:10890" // Optional, remove if not needed
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@kwp-lab/mcp-brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE",
        "BRAVE_SEARCH_PROXY": "https://example.com:10890" // Optional, remove if not needed
      }
    }
  }
}

Uso con VS Code

Para una instalación rápida, utilice los botones de instalación de un solo clic que aparecen a continuación...

Instalar con NPX en VS Code Instalar con NPX en VS Code Insiders

Instalar con Docker en VS Code Instalar con Docker en VS Code Insiders

Para la instalación manual, agregue el siguiente bloque JSON a su archivo de configuración de usuario (JSON) en VS Code. Para ello, presione Ctrl + Shift + P y escriba Preferences: Open User Settings (JSON) .

Opcionalmente, puede agregarlo a un archivo llamado .vscode/mcp.json en su espacio de trabajo. Esto le permitirá compartir la configuración con otros.

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

Estibador

{
  "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}",
          "BRAVE_SEARCH_PROXY": "https://example.com:10890" // Optional, remove if not needed
        }
      }
    }
  }
}

NPX

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "brave_api_key",
        "description": "Brave Search API Key",
        "password": true
      }
    ],
    "servers": {
      "brave-search": {
        "command": "npx",
        "args": ["-y", "@kwp-lab/mcp-brave-search"],
        "env": {
          "BRAVE_API_KEY": "${input:brave_api_key}",
          "BRAVE_SEARCH_PROXY": "https://example.com:10890" // Optional, remove if not needed
        }
      }
    }
  }
}

Construir

Compilación de Docker:

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

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.

Available Tools

2 tools

Tool Schema Changelog

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

  1. 2 tool updates
    • First observedbrave_local_search
    • First observedbrave_web_search
Install Server
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

TDQS

A4.3/5.0

Scored across 2 tools

Disambiguation5/5

The two tools have clearly distinct purposes: brave_local_search targets local businesses and physical locations with 'near me' queries, while brave_web_search handles general web searches for information, news, and online content. There is no overlap in functionality, as each tool is specialized for different query types and data sources, making it easy for an agent to choose the correct one based on the user's intent.

Naming Consistency5/5

Both tool names follow a consistent pattern: 'brave_' prefix followed by a descriptive term ('local_search' and 'web_search') using snake_case. This naming convention clearly indicates the server domain (Brave Search) and the specific search type, making the tools predictable and easy to understand without any deviations or mixed styles.

Tool Count3/5

With only 2 tools, the server feels thin for a search domain, as it might benefit from additional tools like image search, news search, or advanced filtering options. However, the tools cover the core local and web search functionalities adequately, so it's borderline but not severely lacking. A typical search server would have more tools to handle diverse query types and result formats.

Completeness4/5

The server covers the essential search operations for local and web queries, with each tool providing detailed capabilities like pagination, filtering, and fallback mechanisms. Minor gaps exist, such as no dedicated tools for image or video searches, but agents can work around this using the web search tool. The surface is reasonably complete for basic search needs without significant dead ends.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Brave Search MCP Server

    Shoofio
    A
    license
    Not graded
    quality
    F
    maintenance
    An MCP server that integrates the Brave Search API to provide both web and local search capabilities, with features like pagination, filtering, and smart fallbacks.
    15
    MIT

  • Brave Search MCP

    mikechao
    A
    license
    A
    quality
    D
    maintenance
    An MCP Server implementation that integrates the Brave Search API, providing, Web Search, Local Points of Interest Search, Image Search, Video Search, News Search and LLM Context Search capabilities
    5
    196
    125
    GPL 3.0