Brave Search MCP

brave/brave-search-mcp-server· Проверено 12.11.2026· 1,6 тыс.на GitHub

Подключает агента к Brave Search API: веб-поиск, новости, картинки, видео, места на карте и готовые выжимки страниц для ответов модели.

Как подключить

Что сделать до подключения

1

Node.js с командой npx; без Node.js есть образ Docker mcp/brave-search

2

Аккаунт Brave Search API с выбранным тарифом Search или Answers

3
BRAVE_API_KEY

brave.com/search/api → регистрация и тариф → ключ в developer dashboard, раздел Keys

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'BRAVE_API_KEY=<ключ Brave Search API>' --transport stdio brave-search \
  -- npx -y @brave/brave-search-mcp-server --transport stdio

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Инструменты сервера

brave_web_searchищет в интернете
brave_news_searchищет свежие новости
brave_image_searchищет картинки
brave_video_searchищет видео
brave_local_searchищет компании рядом
brave_place_searchищет места в заданном районе
brave_summarizerсоставляет сводку по выдаче
brave_llm_contextотдаёт выжимки страниц для модели

Что попросить агента

«Что нового про <тема> за последние сутки?»Агент вызовет brave_news_search: по умолчанию он ищет новости за 24 часа
«Найди кофейни в радиусе 500 м от <адрес или координаты>»Агент вызовет brave_place_search с координатами и радиусом
«Подбери 10 картинок <тема> для презентации»Агент вызовет brave_image_search с count: 10
«Коротко ответь на вопрос <вопрос> по свежей выдаче»Агент вызовет brave_web_search с summary: true, затем brave_summarizer

Для каких задач

Найти свежие новости за последние сутки
Подобрать картинки или видео по теме с размерами и превью
Найти кафе, магазины и другие места в радиусе от точки с часами работы и рейтингом
Получить готовые фрагменты страниц под ответ модели без отдельного скачивания
Составить сводку по выдаче через Summarizer

Ограничения

!

Нужен аккаунт Brave Search API с выбранным тарифом Search или Answers

!

Полный локальный поиск и дополнительные фрагменты extra_snippets работают только на тарифе Pro; без него brave_local_search переходит на обычный веб-поиск

!

Страна и язык поиска по умолчанию — US и en: для русской выдачи задавайте country и search_lang

!

В режиме HTTP сервер не проверяет пароль: открывать его на 0.0.0.0 можно только в доверенной сети

Если не работает

После обновления до версии 2.x пропал HTTP-сервер
С версии 2.x сервер по умолчанию работает через stdio. Для HTTP задайте BRAVE_MCP_TRANSPORT=http или флаг --transport http.
Браузерный клиент получает HTTP 403
Запросы с чужим заголовком Origin отклоняются. Добавьте адрес клиента в BRAVE_MCP_ALLOWED_ORIGINS.
brave_image_search больше не возвращает картинки в base64
С версии 2.x base64 убран, чтобы не тратить контекст: в ответе остаются адреса изображений.

Частые вопросы

Где взять ключ?
Зарегистрируйтесь в Brave Search API, выберите тариф Search или Answers и создайте ключ в developer dashboard. Для Docker ключ можно хранить в файле и указать путь в BRAVE_API_KEY_FILE.
Как получить сводку вместо списка ссылок?
Сначала агент вызывает brave_web_search с summary: true, затем передаёт полученный ключ в brave_summarizer.
Как оставить только нужные инструменты?
Перечислите их через пробел в BRAVE_MCP_ENABLED_TOOLS или, наоборот, отключите лишние через BRAVE_MCP_DISABLED_TOOLS.
Как запустить сервер по HTTP?
Задайте BRAVE_MCP_TRANSPORT=http или флаг --transport http. Сервер слушает 127.0.0.1:8080; порт меняется BRAVE_MCP_PORT, адрес — BRAVE_MCP_HOST.
Работает ли сервер из России?
Поиск идёт через Brave Search API, поэтому нужен доступ к сервису из вашей сети и аккаунт с тарифом; сам сервер запускается на вашем компьютере.

Похожие серверы