MCP-сервер поиска Яндекса с офлайн-установкой
MCP Search Server
MCP-сервер поиска через Yandex Cloud Search API с панелью мониторинга, фолбэком на Brave и офлайн-пакетом для закрытых сетей
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Инструменты только ищут и читают публичные страницы
- fetch_url обходит некоторые блокировки WAF, что стоит использовать ответственно
Установка
Ручная установка
pip install git+https://github.com/in40/mcp-search-server.gitОнлайн-установка при наличии интернета.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает два инструмента по 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 для авторизации
Пример запроса к агенту
Найди последние новости про изменения в законодательстве о такси и открой полный текст первой статьиОграничения
Нужны переменные YANDEX_SEARCH_API_KEY и YANDEX_FOLDER_ID сервисного аккаунта Yandex Cloud. Полная офлайн-сборка весит 330 МБ из-за встроенного Chromium. Авторизация MCP и панели идет через заголовок X-API-Key и локальный файл api_keys.json, который нужно вести самостоятельно.
Как отключить. Остановите процесс mcp-search-server и удалите его адрес из конфигурации MCP клиента.
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 |
Проверка безопасности
- Инструменты только ищут и читают публичные страницы
- fetch_url обходит некоторые блокировки WAF, что стоит использовать ответственно
Коротко о README
README показывает онлайн и офлайн установку с готовыми бандлами под разные размеры, объясняет архитектуру с портами MCP JSON-RPC, REST API и панелью мониторинга, дает таблицу переменных окружения, схему авторизации по X-API-Key и примеры Dockerfile для обычного Debian-образа и для сертифицированной Astra Linux.
Частые вопросы
Можно ли развернуть без интернета?
Да, на странице релизов есть офлайн-бандлы с локальными wheels, легкий без браузера и полный с Playwright и Chromium.
Что если сайт блокирует запрос?
fetch_url последовательно пробует requests, повтор без проверки SSL, curl в обход WAF и Playwright для JS-тяжелых страниц.
Похожие
CLI, скилл и Python-библиотека для управления браузером: агент кликает, заполняет формы и читает страницы через CDP
Скилл собирает обсуждения темы за последние 30 дней из Reddit, X, YouTube, HN, Polymarket и GitHub и сводит их в бриф
Официальный MCP-сервер команды Chrome DevTools: агент управляет живым Chrome, смотрит сеть, консоль и записывает трейсы производительности
Быстрый CLI на Rust для автоматизации браузера агентами: снимки доступности со ссылками на элементы, MCP-сервер и скиллы