Selectel S3 MCP и CLI: бакеты и бэкапы Селектел

selectel-s3-mcp-ai-cli

Go-бинарь selectel-s3 дает агенту MCP-сервер и CLI для объектного хранилища Selectel с уровнями прав read, write, delete и admin

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

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

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

  • Ключи S3 открывают чтение и скачивание объектов, а флаги записи и удаления добавляют изменение данных в бакетах
  • Временные ссылки отдают содержимое объекта любому, у кого есть адрес
Все причины и проверки
Российский стек

stufently/selectel-s3-mcp-ai-cli

Установка

Сервисы

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

selectel-s3 mcp install --client cursor

После установки бинаря из релизов и `selectel-s3 auth set`; тот же вызов с `--client codex`, `--client claude-desktop` или `--client claude-code --scope user`.

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

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

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

  • Ключи S3 открывают чтение и скачивание объектов, а флаги записи и удаления добавляют изменение данных в бакетах
  • Временные ссылки отдают содержимое объекта любому, у кого есть адрес

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

Что делает

Бинарь `selectel-s3` объединяет MCP-сервер, CLI с потоковой передачей и встроенный скилл для Selectel Object Storage. Через него агент листает бакеты и объекты, читает метаданные и версии, копирует и перемещает объекты, готовит временные ссылки на чтение и запись, ведет составные загрузки и смотрит CORS, политику и Object Lock. Для восстановления бэкапов есть ограниченные сканы: самые крупные объекты, объем по префиксам и брошенные загрузки. Профиль возможностей описывает шесть пулов Selectel и отключает теги, которых у Selectel нет. Команда `selectel-s3 mcp install` записывает конфигурацию для Cursor, Claude Desktop, Codex и Claude Code, а запись, удаление и админ-операции открываются флагами `--allow-write`, `--allow-delete`, `--allow-admin` или переменной `SELECTEL_S3_ALLOW`.

Для кого. Администраторам и разработчикам с резервными копиями в Selectel, которым агент нужен для проверки бакетов и восстановления архивов.

Подходит, если

  • После сбоя надо найти в бакете последний архив и скачать его
  • Хочется понять, какие префиксы занимают больше всего места
  • В бакете висят брошенные составные загрузки
  • Коллеге нужна короткая ссылка на готовый архив

Не подходит, если

  • Хранилище у другого провайдера: для Яндекса, VK Cloud и Timeweb автор ведет отдельные проекты
  • Нужны теги объектов: у Selectel их нет
  • Нужно управление серверами и DNS: бинарь работает только с S3

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

Найди в бакете backups самый свежий архив базы, покажи его размер и дай ссылку на скачивание на час

MCP

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

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

SELECTEL_S3_ACCESS_KEY_ID обязательная
Идентификатор ключа S3 Selectel
SELECTEL_S3_SECRET_ACCESS_KEY обязательная, секрет
Секретный ключ S3
SELECTEL_S3_POOL
Пул, по умолчанию `ru-1`
SELECTEL_S3_ALLOW
Уровни прав: `write`, `delete`, `admin`

Ограничения

Проект на стадии разработки, релиз v0.1.0 опубликован и есть в MCP Registry и Smithery. Бинарь скачивают из релизов, собирают на Go 1.27.2 или запускают образом Docker. Нужны ключи S3 Selectel; секрет не передают в аргументах, `auth set` читает его без эха. Без флагов доступно только чтение. Встроенные операции `get` и `put` ограничены 262 144 байтами, предпросмотр 65 536, а крупные файлы идут по временной ссылке или через `FILE_ROOT`. Списки отдаются до 1000 элементов.

Как отключить. Уберите блок `selectel-s3` из конфигурации клиента, удалите `~/.config/selectel-s3/credentials` и отзовите ключи S3 в панели Selectel.

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

Как подключить Selectel S3 к Cursor?

Командой `selectel-s3 mcp install --client cursor`; пробный прогон без записи даст ключ `--dry-run`. Ключи в конфигурацию не пишутся, Cursor берет их из окружения.

Как включить запись и удаление?

Флагами `--allow-write`, `--allow-delete`, `--allow-admin` или переменной `SELECTEL_S3_ALLOW=write,delete,admin`; уровни включаются независимо.

Какой пул используется по умолчанию?

Пул `ru-1`; другой задают переменной `SELECTEL_S3_POOL` или флагом `--pool`.

Что делает команда `selectel-s3 auth set`?

Спрашивает идентификатор ключа и секрет без эха и сохраняет их в `~/.config/selectel-s3/credentials` с правами 0600; более широкие права отклоняются.

Какие инструменты помогают разбирать бэкапы?

`s3_largest_objects` ищет самые крупные объекты, `s3_prefix_usage` считает объем по префиксам, а `s3_unfinished_uploads` находит брошенные загрузки.

Обсуждение

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

Российский стек

Облачные серверы, диски, сеть, DNS, S3 и биллинг Selectel из агента, с режимом readonly и планом перед каждым изменением

MCP-серверШирокий доступ
Российский стек

Неофициальный MCP-сервер облака Selectel: облачные серверы OpenStack, S3-хранилище, баланс и деплой Docker-приложения одним вызовом

MCP-серверШирокий доступ1Звезды репозитория
Российский стек

MCP-сервер для биллинга Selectel: баланс и прогноз списаний через сервисного пользователя, с автообновлением токена и аудитом

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

MCP-сервер для облачной платформы Selectel на FastMCP: проекты, ресурсы и квоты, задуман как первый из шести сервисных MCP

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

selvpc (Selectel VPC)

python-selvpcclient

Официальный

Python-клиент и CLI selvpc для API облачной платформы Selectel

CLIШирокий доступ8Звезды репозитория

Коротко о README

В README разобраны быстрый старт с бинарем и образом Docker, подключение к Claude Code, Cursor и Codex, таблица инструментов по уровням прав и лимиты размера. Есть английская версия и ссылка на каталог S3 MCP-серверов того же автора.

Бейдж для README

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