Brave Search MCP Server

Что умеет сервер

Сервер выпускает сама Brave и подключает агента к Brave Search API. Он отдаёт восемь инструментов: brave_web_search для обычного поиска с фильтрами по стране, языку, свежести и безопасному режиму, brave_news_search, brave_video_search, brave_image_search, brave_local_search и brave_place_search для компаний и точек на карте, а также brave_summarizer для краткого ответа по найденному. Отдельно стоит brave_llm_context: он возвращает заранее извлечённые фрагменты страниц, которыми можно подкрепить ответ модели, и позволяет ограничить число адресов, фрагментов и токенов.

Результаты можно переранжировать собственными правилами Goggles, а набор доступных инструментов сузить переменными BRAVE_MCP_ENABLED_TOOLS и BRAVE_MCP_DISABLED_TOOLS. Это полезно, если не хочется тратить контекст на описания лишних функций.

Когда использовать

Сервер пригодится, когда агенту нужны актуальные сведения, которых нет в обучающих данных: новости, цены, документация, адреса и часы работы организаций. Для проверки фактов и подготовки справок хватает веб- и новостного поиска, а brave_llm_context удобен, когда ответ строится по найденным источникам и важно получить сразу пригодный для модели текст, а не список ссылок.

Для чтения одной известной страницы поисковик не нужен: проще взять сервер выборки страниц. Если нужен единый вызов для глубокого исследования с рассуждениями, посмотрите на сервисы, которые отдают готовый разбор.

Ограничения и безопасность

Без ключа сервер не работает: ключ получают в кабинете Brave Search API и передают в BRAVE_API_KEY или в файле через BRAVE_API_KEY_FILE. Часть возможностей зависит от тарифа: полноценный локальный поиск и дополнительные выдержки extra_snippets требуют плана Pro, без него локальный поиск уходит в обычный веб-поиск. Запросы ограничены 400 символами и 50 словами.

По умолчанию сервер работает по STDIO. В режиме HTTP он слушает только 127.0.0.1, а его адрес не защищён паролем, поэтому открывать его на 0.0.0.0 стоит только в доверенной сети. Для браузерных клиентов предусмотрены списки разрешённых источников запросов и хостов. Поисковые запросы уходят в Brave, так что конфиденциальные данные в них лучше не включать.

Claude Desktop

Добавьте в claude_desktop_config.json. Вариант с Docker:

{
  "mcpServers": {
    "brave-search": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "BRAVE_API_KEY", "docker.io/mcp/brave-search"],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Вариант с NPX. В этом примере README указывает транспорт HTTP, тогда как по умолчанию сервер работает по STDIO:

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@brave/brave-search-mcp-server", "--transport", "http"],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

VS Code

Добавьте в пользовательские настройки (JSON) или в .vscode/mcp.json. Ключ VS Code спросит при запуске:

{
  "inputs": [
    {
      "password": true,
      "id": "brave-api-key",
      "type": "promptString",
      "description": "Brave Search API Key",
    }
  ],
  "servers": {
    "brave-search-mcp-server": {
      "command": "npx",
      "args": ["-y", "@brave/brave-search-mcp-server", "--transport", "stdio"],
      "env": {
        "BRAVE_API_KEY": "${input:brave-api-key}"
      }
    }
  }
}

fx

Добавьте в ~/.fx/mcp.json (создайте файл, если его нет):

{
  "mcp": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@brave/brave-search-mcp-server", "--transport", "stdio"],
      "env": {
        "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Запустите fx или выполните /mcp reload, а для проверки /mcp list.