SkillFoxx
Telegram

MCP-сервер Yandex Search API v2 по HTTP

Yandex Search API MCP server, StreamableHTTP build

Форк официального сервера Яндекса с добавленным HTTP-транспортом и полным набором типов поиска: веб, генеративный, картинки

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

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

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

  • Сервер в Docker отправляет запросы в платный Yandex Search API по ключу
  • Инструменты только ищут и читают выдачу, включая ИИ-ответ gen_search
Все причины и проверки
Российский стек

msklv/yandex-search-mcp-serverАвтор:msklv

Установка

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

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.

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

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

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

  • Сервер в Docker отправляет запросы в платный Yandex Search API по ключу
  • Инструменты только ищут и читают выдачу, включая ИИ-ответ gen_search

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

Что делает

Сервер форкнут от официального 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: сервис коммерческий, нужен оплаченный ключ

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

Найди картинки кофемашин определенной модели и дай краткий ИИ-ответ с источниками про их надежность

MCP

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

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

SEARCH_API_KEY обязательная, секрет
Ключ Yandex Search API, заголовок Authorization: Api-Key
FOLDER_ID
ID папки Yandex Cloud, обязателен для gen_search

Ограничения

Это неофициальный форк, не продукт и не одобрение Яндекса, хотя часть файлов (server.py, detail.py) унаследована от оригинала под лицензией Apache-2.0 и авторством YANDEX LLC. Yandex Search API платный, нужен ключ и обычно ID папки Yandex Cloud. gen_search требует переменную FOLDER_ID.

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

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

Можно ли использовать как оригинальный stdio-сервер?

Да, python3 server.py сохраняет поведение апстрима, run_http.py добавляет отдельный HTTP-режим.

Нужен ли FOLDER_ID?

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

Чем этот сервер отличается от официального yandex-search-mcp-server?

Это форк официального сервера Яндекса. Оригинал поддерживает только stdio и всегда включает эндпоинт YandexGPT. В форке добавлен файл run_http.py, который отдает тот же сервер по HTTP, и есть полный набор типов поиска: веб, генеративный, картинки.

Нужен ли FOLDER_ID и можно ли использовать как оригинальный stdio-сервер?

FOLDER_ID задается при использовании генеративного поиска, ключ SEARCH_API_KEY нужен всегда. Для stdio берите оригинал от Яндекса, а этот форк запускается в Docker: docker run -p 8766:8766 и работает в Claude Desktop и Cursor.

Обсуждение

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

Яндекс Поиск — все инструменты
Российский стек

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

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

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

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

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

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

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

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

Коротко о README

README честно указывает происхождение как форк официального сервера Яндекса и перечисляет два отличия: HTTP-транспорт через run_http.py и поддержку всех типов поиска Search API v2 вместо только web_search. Дана таблица инструментов с режимами sync и deferred, переменные окружения, команды локального и Docker-запуска и пример вызова web_search с параметрами region.

Бейдж для README

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