Brave Search MCP-сервер

Сервер MCP, использующий API Brave Search для веб-поиска и локального поиска, с дополнительной настройкой HTTP-прокси.

Этот репозиторий является ответвлением серверов Model Context Protocol и заменяет собственную реализацию fetch библиотекой node-fetch-native .

Сервер будет использовать переменные окружения http_proxy и https_proxy для маршрутизации запросов через прокси-сервер по умолчанию, если они установлены. Вы также можете установить переменную окружения BRAVE_SEARCH_PROXY для использования другого прокси-сервера.

Функции

• Поиск в Интернете : общие запросы, новости, статьи с возможностью пагинации и контроля актуальности

• Локальный поиск : найдите предприятия, рестораны и услуги с подробной информацией

• Гибкая фильтрация : контроль типов результатов, уровней безопасности и свежести контента.

• Умные откаты : локальный поиск автоматически возвращается к веб-поиску, если результаты не найдены.

Related MCP server: MCP2Brave

Инструменты

• храбрый_веб_поиск

  • Выполнение веб-поиска с разбивкой на страницы и фильтрацией

  • Входные данные:

    • query (строка): Условия поиска

    • count (число, необязательно): Результаты на страницу (макс. 20)

    • offset (число, необязательно): смещение пагинации (макс. 9)

• храбрый_локальный_поиск

  • Поиск местных предприятий и услуг

  • Входные данные:

    • query (строка): Локальные поисковые термины

    • count (число, необязательно): Количество результатов (макс. 20)

  • Автоматически возвращается к веб-поиску, если локальные результаты не найдены

Конфигурация

Получение API-ключа

1. Зарегистрируйте учетную запись Brave Search API

2. Выберите план (доступен бесплатный тариф с 2000 запросов в месяц)

3. Сгенерируйте свой ключ API из панели разработчика

Использование с Claude Desktop

Добавьте это в ваш claude_desktop_config.json :

Докер

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

НПХ

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

Использование с VS Code

Для быстрой установки используйте кнопки установки в один клик ниже...

Для ручной установки добавьте следующий блок JSON в файл настроек пользователя (JSON) в VS Code. Это можно сделать, нажав Ctrl + Shift + P и введя Preferences: Open User Settings (JSON) .

При желании вы можете добавить его в файл .vscode/mcp.json в вашем рабочем пространстве. Это позволит вам поделиться конфигурацией с другими.

Обратите внимание, что ключ mcp не нужен в файле .vscode/mcp.json .

Докер

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

НПХ

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

Строить

Сборка Docker:

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

Лицензия

Этот сервер MCP лицензирован по лицензии MIT. Это означает, что вы можете свободно использовать, изменять и распространять программное обеспечение в соответствии с условиями лицензии MIT. Для получения более подробной информации см. файл LICENSE в репозитории проекта.