MCP-сервер поиска Яндекса с офлайн-установкой

MCP Search Server

MCP-сервер поиска через Yandex Cloud Search API с панелью мониторинга, фолбэком на Brave и офлайн-пакетом для закрытых сетей

  • 0 ★ репозитория
  • Последний коммит
  • Apache-2.0
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Запускает Python-сервер с поиском через Yandex Search API и Brave
  • fetch_url качает страницы через curl и Playwright с Chromium, обходя часть защит WAF
Все причины и проверки
Российский стек

in40/mcp-search-server

Установка

Ручная установка

pip install git+https://github.com/in40/mcp-search-server.git

Онлайн-установка при наличии интернета.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Запускает Python-сервер с поиском через Yandex Search API и Brave
  • fetch_url качает страницы через curl и Playwright с Chromium, обходя часть защит WAF

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер дает два инструмента по JSON-RPC 2.0: internet_search на основе Yandex Cloud Search API с фолбэком на Brave Search API и fetch_url с многоуровневым обходом блокировок, requests с Chrome UA, retry без проверки SSL, curl в обход некоторых WAF, Playwright для JS-тяжелых страниц и отдельный путь для зеркал Википедии, защищенных QRATOR. Контент со страниц извлекается через trafilatura в markdown. Отдельная веб-панель на порту 8091 показывает статистику запросов, живой лог с автообновлением и детали по каждому запросу. Для закрытых сетей есть офлайн-сборки: легкая на 21 МБ без браузера и полная на 330 МБ с Playwright и Chromium, включая готовый Dockerfile под Astra Linux.

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

Подходит, если

  • Нужен деплой в закрытой сети или на сертифицированной российской ОС Astra Linux
  • Важна живая панель мониторинга запросов и логов, а не просто консольный вывод
  • Нужен фолбэк на Brave, если Yandex Cloud Search API недоступен

Не подходит, если

  • Нужен только stdio без REST и без панели: тут это самостоятельное приложение с двумя портами
  • Не хочется поднимать X-API-Key и файл api_keys.json для авторизации

Пример запроса к агенту

Найди последние новости про изменения в законодательстве о такси и открой полный текст первой статьи

MCP

Транспорт
stdio, http
Авторизация
API-ключ

Переменные окружения

YANDEX_SEARCH_API_KEY обязательная, секрет
Ключ Yandex Cloud для Search API
YANDEX_FOLDER_ID обязательная
ID папки Yandex Cloud
YANDEX_SEARCH_TYPE
SEARCH_TYPE_COM по умолчанию, SEARCH_TYPE_RU для русской выдачи
SEARCH_PROVIDER
yandex по умолчанию, brave переключает на Brave Search API

Ограничения

Нужны переменные YANDEX_SEARCH_API_KEY и YANDEX_FOLDER_ID сервисного аккаунта Yandex Cloud. Полная офлайн-сборка весит 330 МБ из-за встроенного Chromium. Авторизация MCP и панели идет через заголовок X-API-Key и локальный файл api_keys.json, который нужно вести самостоятельно.

Как отключить. Остановите процесс mcp-search-server и удалите его адрес из конфигурации MCP клиента.

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

Можно ли развернуть без интернета?

Да, на странице релизов есть офлайн-бандлы с локальными wheels, легкий без браузера и полный с Playwright и Chromium.

Что если сайт блокирует запрос?

fetch_url последовательно пробует requests, повтор без проверки SSL, curl в обход WAF и Playwright для JS-тяжелых страниц.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

MCP-сервер поиска Яндекса на .NET 10 с нативной AOT-сборкой, конвертацией страниц в Markdown и поиском по regex

MCP-серверРасширенный доступ
Российский стек

Self-hosted MCP для Yandex Search API v2: веб, картинки и генеративный поиск по всем шести индексам Яндекса

MCP-серверРасширенный доступ4Звезды репозитория
Российский стек

Неофициальный MCP-сервер на Playwright: ищет в Яндексе через браузер с авторизованными cookies, извлекает и ранжирует контент страниц для агента

MCP-серверШирокий доступ4Звезды репозитория
Российский стек

MCP-сервер веб-поиска и извлечения контента через Яндекс и Google на базе SerpAPI, с прицелом на результаты для России и СНГ

MCP-серверРасширенный доступ1Звезды репозитория
Российский стек

Форк официального сервера Яндекса с отложенным async-поиском по умолчанию, который экономит до 94% на тарифе Search API

MCP-серверРасширенный доступ

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
MCP-сервер поиска Яндекса с офлайн-установкой (эта карточка)нетAPI-ключ0
MCP-сервер поиска Яндекса через браузернетне нужна4ищет в Яндексе через браузер с cookies
MCP-сервер поиска Яндекса и Googleнетне нужна1поиск через Яндекс и Google на SerpAPI
MCP-сервер поиска Яндекса на TypeScriptнетAPI-ключ0на TypeScript, со своим парсером выдачи

Коротко о README

README показывает онлайн и офлайн установку с готовыми бандлами под разные размеры, объясняет архитектуру с портами MCP JSON-RPC, REST API и панелью мониторинга, дает таблицу переменных окружения, схему авторизации по X-API-Key и примеры Dockerfile для обычного Debian-образа и для сертифицированной Astra Linux.

Бейдж для README

Сообщить о проблеме