Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Bewertungen und Benutzerkonten folgen in einem späteren Schritt.
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

Vkcloud S3 MCP AI Cli

von stufentlyVersion 0.1.0i★ –iLäuft auf deinem Computer
Name in der Registryio.github.stufently/vkcloud-s3-mcp-ai-cli

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

VK Cloud S3 MCP server and AI CLI with scoped access and human approval for destructive actions.

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

  • Verbindung: Läuft auf deinem Computer
  • Transport: stdio
  • Kategorie: Sonstiges
  • Das musst du eintragen: VKCLOUD_S3_ACCESS_KEY_ID, VKCLOUD_S3_SECRET_ACCESS_KEY

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

  • Basischecks: 1 von 1 bestanden
  • Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
  • Das trägst du selbst ein: VKCLOUD_S3_ACCESS_KEY_ID, VKCLOUD_S3_SECRET_ACCESS_KEY, VKCLOUD_S3_POOL, VKCLOUD_S3_ENDPOINT, VKCLOUD_S3_ALLOW_INSECURE, VKCLOUD_S3_ALLOW, VKCLOUD_S3_DESTRUCTIVE_POLICY, VKCLOUD_S3_ALLOWED_BUCKETS, VKCLOUD_S3_ALLOWED_PREFIXES, VKCLOUD_S3_FILE_ROOT, VKCLOUD_S3_AUDIT_FILE

Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.

Du brauchst

Welche App nutzt du?

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

{
  "mcpServers": {
    "vkcloud-s3-ai-cli": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VKCLOUD_S3_ACCESS_KEY_ID",
        "-e",
        "VKCLOUD_S3_SECRET_ACCESS_KEY",
        "-e",
        "VKCLOUD_S3_POOL",
        "-e",
        "VKCLOUD_S3_ENDPOINT",
        "-e",
        "VKCLOUD_S3_ALLOW_INSECURE",
        "-e",
        "VKCLOUD_S3_ALLOW",
        "-e",
        "VKCLOUD_S3_DESTRUCTIVE_POLICY",
        "-e",
        "VKCLOUD_S3_ALLOWED_BUCKETS",
        "-e",
        "VKCLOUD_S3_ALLOWED_PREFIXES",
        "-e",
        "VKCLOUD_S3_FILE_ROOT",
        "-e",
        "VKCLOUD_S3_AUDIT_FILE",
        "ghcr.io/stufently/vkcloud-s3-mcp-ai-cli:0.1.0"
      ],
      "env": {
        "VKCLOUD_S3_ACCESS_KEY_ID": "your-value",
        "VKCLOUD_S3_SECRET_ACCESS_KEY": "your-value",
        "VKCLOUD_S3_POOL": "your-value",
        "VKCLOUD_S3_ENDPOINT": "your-value",
        "VKCLOUD_S3_ALLOW_INSECURE": "your-value",
        "VKCLOUD_S3_ALLOW": "your-value",
        "VKCLOUD_S3_DESTRUCTIVE_POLICY": "your-value",
        "VKCLOUD_S3_ALLOWED_BUCKETS": "your-value",
        "VKCLOUD_S3_ALLOWED_PREFIXES": "your-value",
        "VKCLOUD_S3_FILE_ROOT": "your-value",
        "VKCLOUD_S3_AUDIT_FILE": "your-value"
      }
    }
  }
}

Führe das in deinem Terminal aus

claude mcp add vkcloud-s3-ai-cli --env VKCLOUD_S3_ACCESS_KEY_ID=your-value --env VKCLOUD_S3_SECRET_ACCESS_KEY=your-value --env VKCLOUD_S3_POOL=your-value --env VKCLOUD_S3_ENDPOINT=your-value --env VKCLOUD_S3_ALLOW_INSECURE=your-value --env VKCLOUD_S3_ALLOW=your-value --env VKCLOUD_S3_DESTRUCTIVE_POLICY=your-value --env VKCLOUD_S3_ALLOWED_BUCKETS=your-value --env VKCLOUD_S3_ALLOWED_PREFIXES=your-value --env VKCLOUD_S3_FILE_ROOT=your-value --env VKCLOUD_S3_AUDIT_FILE=your-value -- docker run -i --rm -e VKCLOUD_S3_ACCESS_KEY_ID -e VKCLOUD_S3_SECRET_ACCESS_KEY -e VKCLOUD_S3_POOL -e VKCLOUD_S3_ENDPOINT -e VKCLOUD_S3_ALLOW_INSECURE -e VKCLOUD_S3_ALLOW -e VKCLOUD_S3_DESTRUCTIVE_POLICY -e VKCLOUD_S3_ALLOWED_BUCKETS -e VKCLOUD_S3_ALLOWED_PREFIXES -e VKCLOUD_S3_FILE_ROOT -e VKCLOUD_S3_AUDIT_FILE ghcr.io/stufently/vkcloud-s3-mcp-ai-cli:0.1.0

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "vkcloud-s3-ai-cli": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VKCLOUD_S3_ACCESS_KEY_ID",
        "-e",
        "VKCLOUD_S3_SECRET_ACCESS_KEY",
        "-e",
        "VKCLOUD_S3_POOL",
        "-e",
        "VKCLOUD_S3_ENDPOINT",
        "-e",
        "VKCLOUD_S3_ALLOW_INSECURE",
        "-e",
        "VKCLOUD_S3_ALLOW",
        "-e",
        "VKCLOUD_S3_DESTRUCTIVE_POLICY",
        "-e",
        "VKCLOUD_S3_ALLOWED_BUCKETS",
        "-e",
        "VKCLOUD_S3_ALLOWED_PREFIXES",
        "-e",
        "VKCLOUD_S3_FILE_ROOT",
        "-e",
        "VKCLOUD_S3_AUDIT_FILE",
        "ghcr.io/stufently/vkcloud-s3-mcp-ai-cli:0.1.0"
      ],
      "env": {
        "VKCLOUD_S3_ACCESS_KEY_ID": "your-value",
        "VKCLOUD_S3_SECRET_ACCESS_KEY": "your-value",
        "VKCLOUD_S3_POOL": "your-value",
        "VKCLOUD_S3_ENDPOINT": "your-value",
        "VKCLOUD_S3_ALLOW_INSECURE": "your-value",
        "VKCLOUD_S3_ALLOW": "your-value",
        "VKCLOUD_S3_DESTRUCTIVE_POLICY": "your-value",
        "VKCLOUD_S3_ALLOWED_BUCKETS": "your-value",
        "VKCLOUD_S3_ALLOWED_PREFIXES": "your-value",
        "VKCLOUD_S3_FILE_ROOT": "your-value",
        "VKCLOUD_S3_AUDIT_FILE": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "vkcloud-s3-ai-cli": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VKCLOUD_S3_ACCESS_KEY_ID",
        "-e",
        "VKCLOUD_S3_SECRET_ACCESS_KEY",
        "-e",
        "VKCLOUD_S3_POOL",
        "-e",
        "VKCLOUD_S3_ENDPOINT",
        "-e",
        "VKCLOUD_S3_ALLOW_INSECURE",
        "-e",
        "VKCLOUD_S3_ALLOW",
        "-e",
        "VKCLOUD_S3_DESTRUCTIVE_POLICY",
        "-e",
        "VKCLOUD_S3_ALLOWED_BUCKETS",
        "-e",
        "VKCLOUD_S3_ALLOWED_PREFIXES",
        "-e",
        "VKCLOUD_S3_FILE_ROOT",
        "-e",
        "VKCLOUD_S3_AUDIT_FILE",
        "ghcr.io/stufently/vkcloud-s3-mcp-ai-cli:0.1.0"
      ],
      "env": {
        "VKCLOUD_S3_ACCESS_KEY_ID": "your-value",
        "VKCLOUD_S3_SECRET_ACCESS_KEY": "your-value",
        "VKCLOUD_S3_POOL": "your-value",
        "VKCLOUD_S3_ENDPOINT": "your-value",
        "VKCLOUD_S3_ALLOW_INSECURE": "your-value",
        "VKCLOUD_S3_ALLOW": "your-value",
        "VKCLOUD_S3_DESTRUCTIVE_POLICY": "your-value",
        "VKCLOUD_S3_ALLOWED_BUCKETS": "your-value",
        "VKCLOUD_S3_ALLOWED_PREFIXES": "your-value",
        "VKCLOUD_S3_FILE_ROOT": "your-value",
        "VKCLOUD_S3_AUDIT_FILE": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

  • VKCLOUD_S3_ACCESS_KEY_ID geheim env
    S3 access key ID
  • VKCLOUD_S3_SECRET_ACCESS_KEY geheim env
    S3 secret access key
  • VKCLOUD_S3_POOL env
    Signing pool
  • VKCLOUD_S3_ENDPOINT env
    Optional endpoint override
  • VKCLOUD_S3_ALLOW_INSECURE env
    Set 1 only for explicit HTTP test endpoints
  • VKCLOUD_S3_ALLOW env
    Independent write,delete,admin levels; read only by default
  • VKCLOUD_S3_DESTRUCTIVE_POLICY env
  • VKCLOUD_S3_ALLOWED_BUCKETS env
    Comma-separated bucket scope
  • VKCLOUD_S3_ALLOWED_PREFIXES env
    Comma-separated bucket/prefix/ scope
  • VKCLOUD_S3_FILE_ROOT env
    Optional confined local file root
  • VKCLOUD_S3_AUDIT_FILE env
    Optional private append-only audit output

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 7. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto stufently bestätigt, dem das Repo gehört

  • … Noch nicht geprüft

    Wird noch gepflegt

    Dieses Repo haben wir noch nicht von GitHub gelesen

  • … Noch nicht geprüft

    Hat eine Lizenz

    Dieses Repo haben wir noch nicht von GitHub gelesen

  • – Nicht zutreffend

    Endpunkt antwortet

    Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Im Vergleich mit anderen in Sonstigesi

  • Mehr Sterne als 0 % der anderen 32708 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 63 % der anderen 32708 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 100 % der anderen 32708 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Vkcloud S3 MCP AI Cli sicher?

Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: VKCLOUD_S3_ACCESS_KEY_ID, VKCLOUD_S3_SECRET_ACCESS_KEY

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.1.0) kam vor 23 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Docker auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Spec Driven Development, Remote Desktop Commander, OpenTakeoff

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Spec Driven Development

von formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Läuft auf deinem Computer★ 440MITAktualisiert vor 14 Monaten
Installieren

Remote Desktop Commander

von desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Läuft in der Cloud★ 211Aktualisiert vorgestern
Installieren

OpenTakeoff

von Kentucky-ai

Construction takeoff for AI agents: load plans, set scale, measure, count, export with provenance.

Läuft auf deinem ComputerAktualisiert heute
Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

VK Cloud S3 MCP Server & AI CLI

MCP-сервер и CLI для S3 VK Cloud (ВК Облако): подключение Hotbox/Icebox к Claude Code, Cursor и Codex, просмотр объектов и скачивание бэкапов. Бинарь vkcloud-s3 использует отдельный профиль возможностей облака.

English guide · Каталог S3 MCP-серверов

English

A Go MCP server, CLI and agent skill for VK Cloud S3 Object Storage. Connect Claude Code, Cursor and Codex to scoped object storage for inspection and backup recovery. ru-msk and kz-ast pools; bucket tagging is disabled. See the full English guide.

Быстрый старт

Возьми бинарь своей платформы из Releases (v0.1.0 опубликован; есть в MCP Registry и Smithery) либо собери с Go 1.27.2:

bash scripts/go.sh go build -o vkcloud-s3 ./cmd/vkcloud-s3

./vkcloud-s3 version ./vkcloud-s3 auth set ./vkcloud-s3 auth status ./vkcloud-s3 ls --json

auth set спрашивает key ID и secret без эха; без TTY читает две строки stdin. Не передавай секрет в argv. Файл ~/.config/vkcloud-s3/credentials создаётся атомарно с 0600; более широкие права отклоняются.

Приоритет: флаги > env > файл. Переменные: VKCLOUD_S3_ACCESS_KEY_ID, VKCLOUD_S3_SECRET_ACCESS_KEY, VKCLOUD_S3_POOL (ru-msk), VKCLOUD_S3_ENDPOINT. HTTP требует VKCLOUD_S3_ALLOW_INSECURE=1.

Образ: ghcr.io/stufently/vkcloud-s3-mcp-ai-cli:0.1.0; локальная сборка: docker build -t vkcloud-s3 . Образ запускает MCP от uid 65532, содержит CA-сертификаты. Передай креды через приватное окружение/файл.

Возможности

  • Потоковые object CRUD, copy, multipart и presigned URL в пределах профиля.
  • Версии, теги, CORS, политика и Object Lock configuration регистрируются при наличии поддержки.
  • Ограниченные сканы, диагностика, JSON, установка MCP и встроенного skill.

Подключение к Claude Code, Cursor, Codex

Кнопка ставит MCP из Docker-образа ghcr.io/stufently/vkcloud-s3-mcp-ai-cli:0.1.0 в режиме только чтения. Ключи в конфиг не пишутся: Cursor подставляет ${env:…} из окружения, поэтому задай VKCLOUD_S3_ACCESS_KEY_ID и VKCLOUD_S3_SECRET_ACCESS_KEY там, откуда запускается Cursor; VKCLOUD_S3_POOL — если бакет не в пуле по умолчанию (пустое значение = пул по умолчанию). Тот же блок — для Windsurf (mcp_config.json) и вручную для ~/.cursor/mcp.json:

{

"mcpServers": { "vkcloud-s3": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "VKCLOUD_S3_ACCESS_KEY_ID", "-e", "VKCLOUD_S3_SECRET_ACCESS_KEY", "-e", "VKCLOUD_S3_POOL", "ghcr.io/stufently/vkcloud-s3-mcp-ai-cli:0.1.0" ], "env": { "VKCLOUD_S3_ACCESS_KEY_ID": "${env:VKCLOUD_S3_ACCESS_KEY_ID}", "VKCLOUD_S3_SECRET_ACCESS_KEY": "${env:VKCLOUD_S3_SECRET_ACCESS_KEY}", "VKCLOUD_S3_POOL": "${env:VKCLOUD_S3_POOL}" } } } }

vkcloud-s3 mcp install --client cursor --dry-run

vkcloud-s3 mcp install --client cursor vkcloud-s3 mcp install --client claude-desktop vkcloud-s3 mcp install --client codex vkcloud-s3 mcp install --client claude-code --scope project vkcloud-s3 mcp install --client claude-code --scope user

Последняя команда только печатает claude mcp add. Путь бинаря абсолютный; ключи в конфиг не пишутся. Cursor: ~/.cursor/mcp.json, Claude Code project: ./.mcp.json; Desktop — каталог конфигурации своей ОС. JSON сохраняет чужие ключи, .bak и идемпотентность.

Codex: ~/.codex/config.toml. Существующая таблица требует --force; заменяется только блок между # >>> vkcloud-s3 (managed) / # <<< vkcloud-s3 (managed). Таблица без маркеров не заменяется даже с --force; остальные байты TOML целы.

Уровни включаются независимо: vkcloud-s3 mcp --allow-write --allow-delete --allow-admin либо VKCLOUD_S3_ALLOW=write,delete,admin. Флаги доступны и в mcp install. FILE_ROOT включается через VKCLOUD_S3_FILE_ROOT.

Инструменты MCP

LevelTools
reads3_list_buckets, s3_list_objects, s3_head_object, s3_get_object, s3_preview_object, s3_presign_get, s3_list_object_versions, s3_list_multipart_uploads, s3_list_parts, s3_get_bucket_config, s3_largest_objects, s3_prefix_usage, s3_unfinished_uploads, s3_get_object_tagging
read + FILE_ROOTs3_download_file
writes3_put_object, s3_create_folder, s3_copy_object, s3_presign_put, s3_multipart_create, s3_multipart_presign_part, s3_multipart_complete, s3_put_object_tagging
write + FILE_ROOTs3_upload_file
deletes3_delete_object, s3_delete_objects, s3_multipart_abort
admins3_create_bucket, s3_put_bucket_versioning, s3_put_bucket_cors, s3_put_bucket_policy, s3_delete_bucket_policy, s3_put_object_lock_configuration
admin + deletes3_delete_bucket

Ресурсы: vkcloud-s3://config, vkcloud-s3://capabilities, vkcloud-s3://pools. Неподдерживаемые возможности исключают инструменты.

Списки — до 1000 элементов с continuation_token; версии/multipart имеют второй маркер. Inline get/put — 262144 байт, preview — 65536; большие файлы идут через presigned URL или FILE_ROOT. Ответ содержит structuredContent и JSON-текст; текст свыше 256 КиБ заменяется краткой сводкой. Ошибки: code/message/retryable; 429/503 SDK повторяет адаптивно.

Аналитика сканирует максимум max_scan (по умолчанию 10000); partial/token отмечают неполный результат. Prefix usage выдаёт страницы агрегатов через next_result_offset. Это не биллинг.

Сценарий: Проверка Hotbox/Icebox и доступ к нужному региону

Профиль включает московский ru-msk и казахстанский kz-ast пулы. Выберите пул своего бакета, проверьте метаданные Hotbox/Icebox и создайте короткую ссылку для передачи существующего архива:

vkcloud-s3 --pool ru-msk stat backups/daily/archive.tar

vkcloud-s3 --pool ru-msk du backups/daily/ --max-scan 10000 --json vkcloud-s3 --pool ru-msk presign backups/daily/archive.tar --expires 3600

Примеры используют существующий бакет backups и объект daily/archive.tar; замените их своими значениями. Профиль и API облака ещё требуют живой проверки.

CLI

vkcloud-s3 mb backups

vkcloud-s3 cp ./archive.tar s3://backups/daily/archive.tar --part-size 5242880 --overwrite --yes vkcloud-s3 ls backups/daily/ --max-keys 100 --json vkcloud-s3 stat backups/daily/archive.tar vkcloud-s3 cp s3://backups/daily/archive.tar ./restored.tar vkcloud-s3 cp ./directory s3://backups/tree/ --recursive --overwrite --yes vkcloud-s3 cp s3://backups/tree/ ./restored-directory --recursive vkcloud-s3 cp s3://backups/daily/archive.tar s3://backups/copy.tar --overwrite --yes vkcloud-s3 cat backups/daily/notes.txt vkcloud-s3 versions backups/daily/ --json vkcloud-s3 du backups/daily/ --max-scan 10000 --json vkcloud-s3 presign backups/daily/archive.tar --expires 3600 vkcloud-s3 rm backups/copy.tar --yes vkcloud-s3 rb empty-bucket --yes vkcloud-s3 doctor --json vkcloud-s3 compat --markdown

cp принимает обычные локальные пути и S3 URI s3://bucket/key либо vkcloud-s3://bucket/key. Большие загрузки используют manager/multipart, --recursive копирует каталоги/префиксы. Перезапись требует --overwrite и подтверждения; выгрузка атомарна. rm/rb/mv без --yes на не-TTY дают код 2; на TTY спрашивают. --json общий, ошибки — stderr и ненулевой код.

doctor проверяет источник/права кредов, DNS/TLS, часы по Date и ListBuckets: >5 минут — предупреждение, >15 — ошибка.

Skill для AI-агентов

vkcloud-s3 skill install

vkcloud-s3 skill install --target ./agent-skills/vkcloud-s3

По умолчанию ~/.claude/skills/vkcloud-s3. Идемпотентно устанавливает SKILL.md и шесть references: backup/restore, share, least privilege, cost hygiene, migration, incident response. Триггеры: «vkcloud s3», «бакет VK Cloud», «загрузи в s3», «presigned», «бэкап в s3».

Безопасность

Если conditional_writes:false, запись без перезаписи отказывает до S3-запросов: HEAD не даёт атомарной защиты. Для согласованной записи используй --overwrite --yes в CLI либо overwrite:true, confirm:true в MCP, сохраняя политику подтверждения. Если conditional_delete:false, mv и s3_move_object отключены.

MCP по умолчанию регистрирует только read; неподдерживаемые возможности и отсутствующие уровни исключают инструмент.

VKCLOUD_S3_DESTRUCTIVE_POLICY: confirm использует elicitation при поддержке клиента, иначе нужен confirm:true после согласия человека; elicit требует elicitation и не допускает обхода confirm:true; block всегда запрещает, allow выполняет без гейта. Отказ предшествует любым S3-запросам. Гейт покрывает удаления, move, presigned PUT, политику/Object Lock, suspension versioning и перезаписи.

При conditional_writes:true операции put/copy/move/multipart complete/upload file используют overwrite:false, HEAD цели и If-None-Match: *; при false запись по умолчанию отказывает. overwrite:true требует тот же гейт.

Скоуп: VKCLOUD_S3_ALLOWED_BUCKETS=backups и VKCLOUD_S3_ALLOWED_PREFIXES=backups/daily/. Префикс учитывает границу сегмента; daily-evil не подходит. Сегменты '..' отклоняются. Частичный скоуп запрещает целый бакет и широкие списки даже при наличии его в ALLOWED_BUCKETS. Copy/move проверяет источник и цель.

Файловые MCP-инструменты используют os.Root: только относительные пути внутри FILE_ROOT; '..', абсолютные пути и симлинки наружу отклоняются. На каждый вызов одна JSON-строка в stderr; VKCLOUD_S3_AUDIT_FILE дополнительно пишет в 0600. Секреты и X-Amz-Signature/Credential/Security-Token редактируются в логах/ошибках. Полная подписанная ссылка — только результат операции. Ограничивай также права самого S3-ключа.

s3_download_file по умолчанию публикует скачанный файл без замены существующего, в том числе созданного во время скачивания. Для замены передай overwrite:true: применяется разрушительная политика с подтверждением через форму либо confirm:true после согласия человека.

Пулы и классы хранения VK Cloud

Пулы, эндпоинты и классы — в таблице совместимости; каждый факт, цены и ошибки с первоисточниками — в ресерче. Пул по умолчанию: ru-msk; регион SigV4 равен выбранному пулу. В профиле verified:false: проверка на versitygw не подтверждает API облака. Неподтверждённые сведения помечены [предположение]; цены в профиле не являются калькулятором биллинга.

Lifecycle, ACL, bucket tagging и object retention могут поддерживаться облаком, но эта версия не предоставляет инструментов для их настройки; данные профиля описывают совместимость S3 API.

FAQ

Как выбрать endpoint VK Cloud S3? Используйте VKCLOUD_S3_POOL=ru-msk или kz-ast; соответствующий endpoint берётся из профиля совместимости. Не меняйте регион подписи независимо от выбранного сервиса.

Поддерживает ли этот проект Hotbox и Icebox? Оба класса представлены в профиле как STANDARD и STANDARD_IA. Наличие класса в профиле не означает, что CLI автоматически переводит объекты между классами; особенности и цены указаны в ресерче VK Cloud.

Можно ли менять теги бакета VK Cloud через MCP? bucket_tagging выключен; инструменты тегов объектов и бакета не следует считать взаимозаменяемыми. Проверяйте `vkcloud-s3://capabiliti

Nur der Anfang wird gezeigt; den Rest findest du im Repo

PopNx fragen