MCP-сервер Yandex Search API v2 по HTTP
Yandex Search API MCP server, StreamableHTTP build
Форк официального сервера Яндекса с добавленным HTTP-транспортом и полным набором типов поиска: веб, генеративный, картинки
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Все инструменты только читают публичные результаты поиска через платный API
Установка
Ручная установка
docker run --rm -p 8766:8766 -e SEARCH_API_KEY=... [-e FOLDER_ID=...] ghcr.io/msklv/yandex-search-mcp-server:latestГотовый образ из GitHub Container Registry, эндпоинт http://<host>:8766/mcp.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер форкнут от официального yandex/yandex-search-mcp-server, который поддерживает только stdio и всегда включает эндпоинт YandexGPT. Здесь добавлен файл run_http.py, который отдает тот же экземпляр FastMCP по StreamableHTTP на /mcp, так что контейнер ведет себя как обычный HTTP-MCP сервис в связке с другими такими же сервисами. Кроме унаследованного web_search добавлены остальные эндпоинты Search API v2: web_search_async с отложенным опросом операции, gen_search с ИИ-ответом и источниками, image_search и image_search_by_image. По умолчанию используется русский регион и локализация.
Для кого. Для тех, кто собирает стек из нескольких HTTP-MCP серверов в Docker Compose и хочет добавить туда официальный поиск Яндекса по HTTP, а не только по stdio.
Подходит, если
- Нужен Search API v2 по HTTP в общем Docker-стеке с другими MCP-серверами
- Нужны все типы поиска сразу: веб, асинхронный веб, генеративный, картинки по тексту и по изображению
- Устраивает готовый образ из GitHub Container Registry
Не подходит, если
- Нужен только stdio, как в оригинале Яндекса: тогда проще взять официальный сервер напрямую
- Не готовы платить за Yandex Search API: сервис коммерческий, нужен оплаченный ключ
Пример запроса к агенту
Найди картинки кофемашин определенной модели и дай краткий ИИ-ответ с источниками про их надежностьОграничения
Это неофициальный форк, не продукт и не одобрение Яндекса, хотя часть файлов (server.py, detail.py) унаследована от оригинала под лицензией Apache-2.0 и авторством YANDEX LLC. Yandex Search API платный, нужен ключ и обычно ID папки Yandex Cloud. gen_search требует переменную FOLDER_ID.
Как отключить. Остановите контейнер или процесс сервера и удалите его из конфигурации MCP клиента.
MCP
- Транспорт
- http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| SEARCH_API_KEY обязательная, секрет | Ключ Yandex Search API, заголовок Authorization: Api-Key |
| FOLDER_ID | ID папки Yandex Cloud, обязателен для gen_search |
Проверка безопасности
- Все инструменты только читают публичные результаты поиска через платный API
Коротко о README
README честно указывает происхождение как форк официального сервера Яндекса и перечисляет два отличия: HTTP-транспорт через run_http.py и поддержку всех типов поиска Search API v2 вместо только web_search. Дана таблица инструментов с режимами sync и deferred, переменные окружения, команды локального и Docker-запуска и пример вызова web_search с параметрами region.
Частые вопросы
Можно ли использовать как оригинальный stdio-сервер?
Да, python3 server.py сохраняет поведение апстрима, run_http.py добавляет отдельный HTTP-режим.
Нужен ли FOLDER_ID?
Обязателен для gen_search, для остальных инструментов опционален и не всегда нужен для ключей сервисного аккаунта.
Похожие
CLI, скилл и Python-библиотека для управления браузером: агент кликает, заполняет формы и читает страницы через CDP
Скилл собирает обсуждения темы за последние 30 дней из Reddit, X, YouTube, HN, Polymarket и GitHub и сводит их в бриф
Официальный MCP-сервер команды Chrome DevTools: агент управляет живым Chrome, смотрит сеть, консоль и записывает трейсы производительности
Быстрый CLI на Rust для автоматизации браузера агентами: снимки доступности со ссылками на элементы, MCP-сервер и скиллы