brave-search-mcp-server

brave-search-mcp-server

braveMIT
1.1k звёзд168 форков
Brave Search MCP Server соединяет AI-ассистентов с поисковым движком Brave Search. Это официальный инструмент от Brave, который даёт ассистенту доступ к независимому индексу страниц, без привязки к Google или Bing. Сервер подходит разработчикам, которым нужен поиск веба, картинок, видео, новостей и AI-саммари прямо внутри ассистента. С версии 2.x разработчики сделали STDIO основным транспортом, убрав лишнюю нагрузку с контекста (например, base64-кодирование картинок).
Ai-mlSearchBrave
Открыть на GitHub

Установка

npx -y @brave/brave-search-mcp-server

Характеристики

Общее

  • СтатусСообщество
  • Разработчикbrave
  • ЛицензияMIT

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • brave_web_search — полноценный веб-поиск с Rich Results, проверкой орфографии, фильтром свежести, безопасным поиском и Goggles. Можно задать страну, язык результатов, количество (до 20) и смещение (до 9).
  • brave_image_search — поиск изображений. Возвращает прямые URL и метаданные (ширина, высота, формат). В версии 2.x убрана передача base64.
  • brave_video_search — поиск видеороликов по всему вебу.
  • brave_news_search — поиск новостей. Поддерживает фильтры по стране, языку и периоду публикации.
  • brave_local_search — поиск компаний и мест поблизости. Возвращает рейтинг, часы работы, контактные телефоны, адрес и AI-сгенерированное описание.
  • AI-саммари — параметр summary включает генерацию краткого изложения результатов поиска. Ассистент получает готовый контекст для ответа.
  • Goggles — кастомные правила реранжирования от сообщества Brave. Вы можете исключать или продвигать определённые источники.
  • Гибкая настройка выдачи — вы контролируете каждый параметр: от региона (country) и языка (search_lang, ui_lang) до режима безопасного поиска (safesearch) и единиц измерения (units).
  • Пагинация — параметр offset для пролистывания выдачи (до 9).
  • Два транспорта — STDIO (по умолчанию) и HTTP (через BRAVE_MCP_TRANSPORT или аргумент --transport http).

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

Для работы сервера нужен только Node.js и API-ключ Brave Search.

1. Получите API-ключ
Зарегистрируйтесь на brave.com/search/api. Бесплатный тариф даёт 1 500 запросов в месяц — этого хватит для разработки и личных проектов.

2. Настройте MCP-клиент
Добавьте в файл конфигурации вашего клиента (например, claude_desktop_config.json) следующий блок:

{ "mcpServers": { "brave-search": { "command": "npx", "args": ["-y", "@brave/brave-search-mcp-server"], "env": { "BRAVE_API_KEY": "ВАШ_API_КЛЮЧ" } } } }

Если вам нужен HTTP-транспорт, добавьте "BRAVE_MCP_TRANSPORT": "http" в объект env.

3. Перезапустите клиент
Закройте и откройте Claude Desktop, или выполните перезагрузку MCP-серверов в Cursor / Continue.

Примеры запросов

  • «Покажи новости про искусственный интеллект за последнюю неделю на русском языке. Используй Brave Search.»
  • «Найди информацию о компании Brave. Выдай адрес, рейтинг и часы работы через локальный поиск.»
  • «Сравни характеристики RTX 4090 и RX 7900 XTX на основе результатов веб-поиска. Включи AI-саммари.»
  • «Найди изображения по запросу "brutalist architecture interior". Верни только ссылки и размеры.»

Технические детали

  • Язык: TypeScript
  • Транспорт: STDIO (дефолт), HTTP (опционально)
  • Лицензия: MIT
  • Разработчик: Brave Software (GitHub Stars: 1 100+)
  • Совместимость: Любые MCP-клиенты (Claude Desktop, Cursor, VS Code + Continue, GenAIScript, Emacs и др.)

Поделиться