yandex-cloud-docs-mcp - Документация Yandex Cloud локально

Когда звать

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

Что ищет Yandex Cloud Docs MCP

Yandex Cloud Docs MCP - локальный сервер для поиска по копии документации Yandex Cloud. Это независимый проект Сергея Селиванова, не официальный сервер Яндекса. Он предоставляет агенту поиск, чтение найденного документа и проверку состояния индекса через MCP.

Сервер пригодится при работе с облачной инфраструктурой, когда агенту нужен точный раздел инструкции со строками для ссылки. По README рабочие вызовы не обращаются к удалённому сервису документации. Но локальную копию материалов и поисковый индекс сначала нужно подготовить отдельно.

Как устроен поиск

Автор использует SQLite FTS5. Инструмент search_yandex_cloud_docs возвращает пути, фрагменты и диапазоны строк; read_yandex_cloud_doc читает найденный документ, до четырёхсот пронумерованных строк за вызов. Через yandex_cloud_docs_status можно сравнить текущую копию документации и состояние индекса.

В статусе учитываются редакция документации, редакция индекса, изменённые локальные файлы и признак устаревания. Это важнее слова «локальный»: давно скачанный материал не становится актуальным только потому, что доступен без сети. Если индекс устарел, агент должен явно сообщить это рядом с ответом.

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

Что потребуется для подключения

В проверенном package.json указаны версия сервера 1.0.0 и Node.js не ниже 25.7.0. Дополнительно нужны Git, клиент с локальным транспортом stdio и отдельная копия yandex-cloud/docs с папкой md-docs. Сервер не поставляется вместе с корпусом и готовой базой поиска.

README описывает подготовку копии документации, сборку сервера и отдельный запуск индексатора. Затем клиенту передаются абсолютные пути к Node.js, собранному файлу сервера, корню документов и файлу SQLite. Примеры для Claude Code, Claude Desktop и Codex есть у автора. Мы эти команды не выполняли; сначала проверьте исходники и пути на своей машине.

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

Разрешения и обновление

По модели безопасности автора рабочие MCP-инструменты только читают локальные материалы. Команда индексации отдельно записывает SQLite по настроенному пути. Обновление Git-копии и индекса не происходит автоматически при вопросе агенту: это явные действия пользователя или разрешённого процесса.

Собственных ключей Yandex Cloud для поиска по документации не требуется. Сервер не создаёт виртуальные машины, не получает доступ к облачному аккаунту и не выполняет операции, описанные в найденных статьях. Если агент затем предлагает такую операцию другим инструментом, права на неё нужно оценивать отдельно.

Лицензия Apache-2.0 относится к серверу и его документации. Отдельно скачанные материалы Yandex Cloud сохраняют условия своего репозитория; переносить на них лицензию сервера нельзя. На 22 октября 2026 года проверены README, версия и лицензия в закреплённом коммите. Установку, построение индекса и реальные MCP-вызовы мы не проводили.