Skip to main content
Glama
deenesjakoruzh
kwp-lab

Brave Search With Proxy

by kwp-lab
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
JavaScript
Remote

Brave Search MCP-Server

Ein MCP-Server, der die Brave Search API für die Web- und lokale Suche nutzt, mit optionaler HTTP-Proxy-Konfiguration.

Dieses Repository verzweigt sich von den Model Context Protocol-Servern und ersetzt die native fetch Implementierung durch die Bibliothek node-fetch-native .

Der Server verwendet standardmäßig die Umgebungsvariablen http_proxy und https_proxy , um Anfragen über den Proxyserver weiterzuleiten, sofern diese festgelegt sind. Sie können auch die Umgebungsvariable BRAVE_SEARCH_PROXY festlegen, um einen anderen Proxyserver zu verwenden.

Merkmale

  • Websuche : Allgemeine Abfragen, Nachrichten, Artikel, mit Paginierungs- und Aktualitätskontrollen

  • Lokale Suche : Finden Sie Geschäfte, Restaurants und Dienstleistungen mit detaillierten Informationen

  • Flexible Filterung : Kontrollieren Sie Ergebnistypen, Sicherheitsstufen und Inhaltsaktualität

  • Intelligente Fallbacks : Die lokale Suche greift automatisch auf das Web zurück, wenn keine Ergebnisse gefunden werden

Related MCP server: MCP2Brave

Werkzeuge

  • brave_web_search

    • Führen Sie Websuchen mit Paginierung und Filterung durch

    • Eingänge:

      • query (Zeichenfolge): Suchbegriffe

      • count (Anzahl, optional): Ergebnisse pro Seite (max. 20)

      • offset (Zahl, optional): Paginierungsoffset (max. 9)

  • mutige_lokale_Suche

    • Suchen Sie nach lokalen Unternehmen und Dienstleistungen

    • Eingänge:

      • query (Zeichenfolge): Lokale Suchbegriffe

      • count (Zahl, optional): Anzahl der Ergebnisse (max. 20)

    • Fällt automatisch auf die Websuche zurück, wenn keine lokalen Ergebnisse gefunden werden

Konfiguration

Einen API-Schlüssel erhalten

  1. Registrieren Sie sich für ein Brave Search API-Konto

  2. Wählen Sie einen Plan (Kostenlose Stufe verfügbar mit 2.000 Abfragen/Monat)

  3. Generieren Sie Ihren API-Schlüssel über das Entwickler-Dashboard

Verwendung mit Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

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",
        "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
      }
    }
  }
}

Verwendung mit VS Code

Verwenden Sie für eine schnelle Installation die unten stehenden Ein-Klick-Installationsschaltflächen ...

Mit NPX in VS Code installieren Installation mit NPX in VS Code Insiders

Mit Docker in VS Code installieren Installation mit Docker in VS Code Insiders

Für die manuelle Installation fügen Sie den folgenden JSON-Block zu Ihrer Benutzereinstellungsdatei (JSON) in VS Code hinzu. Drücken Sie dazu Ctrl + Shift + P und geben Sie Preferences: Open User Settings (JSON) ein.

Optional können Sie es einer Datei namens .vscode/mcp.json in Ihrem Arbeitsbereich hinzufügen. Dadurch können Sie die Konfiguration mit anderen teilen.

Beachten Sie, dass der mcp Schlüssel in der Datei .vscode/mcp.json nicht benötigt wird.

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}",
          "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
        }
      }
    }
  }
}

Bauen

Docker-Build:

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

Lizenz

Dieser MCP-Server ist unter der MIT-Lizenz lizenziert. Das bedeutet, dass Sie die Software unter den Bedingungen der MIT-Lizenz frei verwenden, ändern und verbreiten dürfen. Weitere Informationen finden Sie in der LICENSE-Datei im Projekt-Repository.

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