VK Cloud S3 MCP и CLI: Hotbox и Icebox для агента
vkcloud-s3-mcp-ai-cli
Бинарь vkcloud-s3 открывает агенту Hotbox и Icebox в ВК Облаке: пулы ru-msk и kz-ast, просмотр объектов и скачивание бэкапов
- 0 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Ключи S3 открывают объекты на чтение, а `--allow-write`, `--allow-delete` и `--allow-admin` добавляют правки и удаление
- Короткие ссылки на архивы работают для любого, кто их получил
Установка
- Работает в
- Сервисы
Ручная установка
vkcloud-s3 mcp install --client cursorПосле бинаря из релизов и `vkcloud-s3 auth set`; остальным клиентам подходит другое значение `--client`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Ключи S3 открывают объекты на чтение, а `--allow-write`, `--allow-delete` и `--allow-admin` добавляют правки и удаление
- Короткие ссылки на архивы работают для любого, кто их получил
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Для объектного хранилища VK Cloud написан бинарь `vkcloud-s3` на Go: MCP-сервер, CLI и скилл в одном файле. Профиль возможностей знает классы Hotbox и Icebox и два пула, московский `ru-msk` и казахстанский `kz-ast`. Агент смотрит бакеты и метаданные объектов, считает размер префикса и делает короткие ссылки на готовые архивы. Те же операции есть в терминале: `vkcloud-s3 --pool ru-msk stat backups/daily/archive.tar`, `du ... --max-scan 10000 --json` и `presign ... --expires 3600`. Запись и удаление по умолчанию закрыты, открывают их `--allow-write` и `--allow-delete` в команде запуска или `VKCLOUD_S3_ALLOW`. Теги бакетов профиль отключает. Подключение к клиентам делает `vkcloud-s3 mcp install`.
Для кого. Командам с бэкапами и архивами в VK Cloud, которым нужно проверять хранилище и доставать файлы из чата с агентом.
Подходит, если
- Надо понять, в Hotbox или Icebox лежит бакет и в каком он регионе
- Нужен размер каталога `backups/daily/` с ограничением на число просмотренных объектов
- Архив нужно отдать коллеге по ссылке на час
- Агенту и скрипту в терминале нужен один и тот же набор команд
Не подходит, если
- Нужны теги бакетов: профиль их отключает
- Хранилище вне VK Cloud: Selectel, Timeweb, Яндекс и другие облака закрывают отдельные проекты автора
- Нужно управление виртуальными машинами: бинарь работает только с S3
Пример запроса к агенту
Проверь в пуле ru-msk, какого класса бакет backups, и дай ссылку на самый свежий архив на часMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
VKCLOUD_S3_ACCESS_KEY_IDобязательная- Идентификатор ключа S3 VK Cloud
VKCLOUD_S3_SECRET_ACCESS_KEYобязательная, секрет- Секретный ключ S3
VKCLOUD_S3_POOL- Пул: `ru-msk` по умолчанию или `kz-ast`
VKCLOUD_S3_ALLOW- Уровни прав: `write`, `delete`, `admin`
Ограничения
Версия 0.1.0 пока свежая, статус проекта разработка. Нужны ключи S3 VK Cloud; пул по умолчанию `ru-msk`, второй доступный `kz-ast`. Бинарь качают из релизов, собирают на Go 1.27.2 или берут образ Docker. Секрет не кладут в аргументы: `vkcloud-s3 auth set` вводит его без эха. Пока не включены запись, удаление и админ-права, сервер только читает. Для адреса без HTTPS нужен `VKCLOUD_S3_ALLOW_INSECURE=1`.
Как отключить. Удалите `vkcloud-s3` из настроек клиента и файл ключей, а в панели VK Cloud отзовите ключи S3.
Частые вопросы
Какие пулы поддерживает vkcloud-s3?
Два: московский `ru-msk` по умолчанию и казахстанский `kz-ast`; выбирают их флагом `--pool` или переменной `VKCLOUD_S3_POOL`.
Как посчитать размер каталога в бакете?
Командой `vkcloud-s3 --pool ru-msk du backups/daily/ --max-scan 10000 --json`; ключ `--max-scan` ограничивает число просмотренных объектов.
Как подключить сервер к Cursor?
Командой `vkcloud-s3 mcp install --client cursor`; с ключом `--dry-run` она сначала покажет, что будет записано.
Что делает `vkcloud-s3 mcp install`?
Записывает конфигурацию MCP в выбранный клиент: Cursor, Claude Desktop, Codex или Claude Code; `--dry-run` сначала показывает правки без записи.
Как создать ссылку на архив?
Командой `vkcloud-s3 --pool ru-msk presign backups/daily/archive.tar --expires 3600`: ссылка живет час.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
VK Cloud — все инструментыMCP-сервер для VK Cloud
VK Cloud MCP Server
Неофициальный MCP-сервер для VK Cloud: виртуальные машины, сети, диски и SSH-ключи через OpenStack-совместимый API
Удаленный MCP-сервер CloudBridge: агент переносит и синхронизирует файлы между 19 облаками, включая Яндекс Диск и VK Облако, по ключу API
Yandex Object Storage: MCP, CLI и скилл для S3 Яндекс Облака
yandex-s3-mcp-ai-cli
Один бинарь на Go: MCP-сервер, CLI и скилл для S3 Яндекс Облака, по умолчанию только чтение, запись и удаление включаются флагами
MCP для Yandex Cloud: VM и Object Storage
yandex-cloud-mcp
MCP-сервер для базовых операций в Yandex Cloud: виртуальные машины, бакеты Object Storage и serverless-функции из диалога с агентом
MCP-сервер и CLI, который дает агенту запрашивать и настраивать облачные, SaaS и API-ресурсы обычными SQL-запросами
Агент работает с Huawei Cloud по подсказкам для двух десятков сервисов, а запись в облаке проходит проверки и согласование
Коротко о README
Документация на двух языках собрана вокруг быстрого старта, образа Docker, кнопки установки для Cursor и команд подключения клиентов. Отдельный сценарий показывает проверку Hotbox и Icebox и выбор региона.