Yandex Object Storage: MCP, CLI и скилл для S3 Яндекс Облака
yandex-s3-mcp-ai-cli
Один бинарь на Go: MCP-сервер, CLI и скилл для S3 Яндекс Облака, по умолчанию только чтение, запись и удаление включаются флагами
- 0 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- При включении write, delete и admin агент меняет и стирает объекты и политики бакетов, включая версии и Object Lock
- Статический ключ Object Storage дает доступ к данным облака, его утечка раскрывает бэкапы
Установка
- Работает в
- Сервисы
Ручная установка
yandex-s3 mcp install --client claude-code --scope userБинарь берут из релизов или собирают из исходников; сначала `yandex-s3 auth set`, затем при желании `yandex-s3 skill install`. Команда печатает `claude mcp add`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- При включении write, delete и admin агент меняет и стирает объекты и политики бакетов, включая версии и Object Lock
- Статический ключ Object Storage дает доступ к данным облака, его утечка раскрывает бэкапы
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Бинарь `yandex-s3` на Go объединяет MCP-сервер, командную строку и скилл для Yandex Object Storage. Агент ищет объекты, смотрит версии и восстанавливает резервные копии: по умолчанию регистрируются только инструменты чтения (`s3_list_objects`, `s3_get_object`, `s3_list_object_versions`, `s3_presign_get`, `s3_prefix_usage` и другие). Запись, удаление и администрирование бакетов включаются отдельно флагами `--allow-write`, `--allow-delete`, `--allow-admin` или переменной `YANDEX_S3_ALLOW`. Опасные операции проходят подтверждение по политике `YANDEX_S3_DESTRUCTIVE_POLICY`. Команда `yandex-s3 mcp install --client cursor` (или `claude-code`, `codex`, `claude-desktop`) прописывает сервер в конфиг клиента без ключей, а `yandex-s3 skill install` кладет `SKILL.md` и шесть справочников в `~/.claude/skills/yandex-s3`.
Для кого. Девопсам и разработчикам, у которых бэкапы и файлы лежат в Yandex Object Storage и агенту нужен безопасный доступ к ним.
Подходит, если
- Перед восстановлением надо проверить содержимое префикса и версии объектов бэкапа
- Агенту нужен доступ только на чтение к бакету, а запись и удаление должны быть закрыты
- Надо найти самые тяжелые объекты и понять, куда уходит место в бакете
- Нужен временный доступ к файлу, и агент выдает presigned-ссылку на нужный срок
Не подходит, если
- Нужна работа с другими S3-хранилищами: сервер настроен под профиль Yandex Object Storage
- Нужна биллинговая сводка: подсчет объема по префиксам не заменяет счет облака
- Нужно быстро включить удаление и запись без подтверждений: гейт по умолчанию требует согласия
Пример запроса к агенту
Покажи версии объектов в префиксе backups/daily/ и найди самый тяжелый файл, ничего не скачиваяMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
YANDEX_S3_ACCESS_KEY_IDобязательная, секрет- Идентификатор статического ключа Object Storage
YANDEX_S3_SECRET_ACCESS_KEYобязательная, секрет- Секретная часть статического ключа
YANDEX_S3_POOL- Пул хранилища, по умолчанию ru-central1
YANDEX_S3_ALLOW- Уровни доступа: write, delete, admin через запятую
Ограничения
Проект имеет статус development: опубликован релиз 0.1.0, а в самом репозитории отмечено, что профиль и API облака еще требуют живой проверки. Работает с одним пулом по умолчанию `ru-central1`, нужны ключ доступа и секрет Object Storage. Если сервис не поддерживает условные записи, запись без перезаписи блокируется до обращения к S3, а перемещение отключено. Встроенное чтение и запись ограничены 262 144 байтами, большие файлы идут через presigned-ссылки или каталог `FILE_ROOT`. Аналитические сканы читают не более 10 000 объектов и не заменяют биллинг. Звезд ноль, последний коммит в октябре 2026 года.
Как отключить. Удалите сервер из конфигурации клиента (файл `.bak` сохранен установщиком), стерите `~/.config/yandex-s3/credentials` и скилл в `~/.claude/skills/yandex-s3`, ключ доступа отзовите в консоли Яндекс Облака.
Частые вопросы
Может ли агент удалять объекты?
По умолчанию нет: регистрируются только инструменты чтения. Удаление включают флагом `--allow-delete`, и каждое действие проходит подтверждение.
Где хранятся ключи?
В файле `~/.config/yandex-s3/credentials` с правами 0600 либо в переменных `YANDEX_S3_ACCESS_KEY_ID` и `YANDEX_S3_SECRET_ACCESS_KEY`. В конфиг клиента они не пишутся.
Как подключить к Cursor или Codex?
Командой `yandex-s3 mcp install --client cursor` или `--client codex`; для проверки сначала добавьте `--dry-run`. Для Cursor есть и кнопка установки из Docker-образа.
Что ставит команда skill install?
Кладет `SKILL.md` и шесть справочников (бэкап и восстановление, доступ, минимум прав, расходы, миграция, инциденты) в `~/.claude/skills/yandex-s3`.
Нужна ли проверка здоровья настроек?
Команда `yandex-s3 doctor` проверяет источник и права ключей, DNS, TLS и расхождение часов: больше пяти минут дает предупреждение, больше пятнадцати ошибку.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер Object Storage Яндекс Облака
yandex-cloude-mcp
Неофициальный однофайловый MCP-сервер для Yandex Object Storage: список бакетов, содержимое и скачивание файлов через AWS SDK
MCP для Yandex Cloud: VM и Object Storage
yandex-cloud-mcp
MCP-сервер для базовых операций в Yandex Cloud: виртуальные машины, бакеты Object Storage и serverless-функции из диалога с агентом
MCP-серверы Yandex Cloud
Yandex Cloud MCP Servers
Официальный набор MCP-серверов Yandex Cloud: документация, поиск, развертывание приложений, serverless-функции, контейнеры и каталог данных
MCP-сервер Yandex Cloud только на чтение
Yandex Cloud MCP Server
Неофициальный MCP-сервер Yandex Cloud только для чтения: виртуальные машины, сети, диски и уровни доступа вплоть до организации
Документация Yandex Cloud в MCP: офлайн-поиск по SQLite
yandex-cloud-docs-mcp
Офлайн MCP-сервер с полнотекстовым поиском по локальной копии документации Yandex Cloud: без сети, только чтение, цитаты со строками
MCP-серверы Yandex AI Studio
MCP Servers in Yandex AI Studio
Официальные демо-шаблоны Яндекса: MCP-шлюзы поверх облачных функций для YandexART, графиков, PDF, arXiv, Kaggle и погоды
Коротко о README
README на русском и английском: быстрый старт с бинарем и `auth set`, подключение к Claude Code, Cursor и Codex, таблица инструментов по уровням доступа, команды CLI, установка скилла, политика подтверждения опасных операций и сценарий проверки версий бэкапов.