Spec Driven Development
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
作者による説明(英語の原文)
VK Cloud S3 MCP server and AI CLI with scoped access and human approval for destructive actions.
この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。
このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。
使っているAIアプリを選んで、設定をコピーしてください。
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「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。
必要なもの
どのアプリを使っていますか?
上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。
Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます
{
"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"
}
}
}
}ターミナルでこれを実行します
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動かす前に、空欄の値を入力してください。
プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます
{
"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"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
プロジェクトの .vscode/mcp.json に貼り付けます
{
"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"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。
選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。
VKCLOUD_S3_POOL envVKCLOUD_S3_ENDPOINT envVKCLOUD_S3_ALLOW_INSECURE envVKCLOUD_S3_ALLOW envVKCLOUD_S3_DESTRUCTIVE_POLICY envVKCLOUD_S3_ALLOWED_BUCKETS envVKCLOUD_S3_ALLOWED_PREFIXES envVKCLOUD_S3_FILE_ROOT envVKCLOUD_S3_AUDIT_FILE envこの設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月7日にチェック
レジストリ名は、リポジトリを所有するGitHubアカウント stufently で確認済みです
このリポジトリはまだGitHubから読み取っていません
このリポジトリはまだGitHubから読み取っていません
これはパソコンで動くため、インターネット上のエンドポイントはありません
パソコンで動き、代わりにローカルの設定を使います
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
入力が必要なもの:VKCLOUD_S3_ACCESS_KEY_ID, VKCLOUD_S3_SECRET_ACCESS_KEY
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
GitHubリポジトリの最終更新は–、最新バージョン(0.1.0)がレジストリに届いたのは23 日前です。
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにDockerも必要です。
同じカテゴリには:Spec Driven Development, Remote Desktop Commander, Date Math
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方:★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
Exact date/time math for agents: business days, holidays, time zones, cron, RRULE, SLA. x402 paid.
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
MCP-сервер и CLI для S3 VK Cloud (ВК Облако): подключение Hotbox/Icebox к Claude Code, Cursor и Codex, просмотр объектов и скачивание бэкапов. Бинарь vkcloud-s3 использует отдельный профиль возможностей облака.
English guide · Каталог S3 MCP-серверов
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-сертификаты. Передай креды через приватное окружение/файл.
Кнопка ставит 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.
| Level | Tools |
|---|---|
| read | s3_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_ROOT | s3_download_file |
| write | s3_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_ROOT | s3_upload_file |
| delete | s3_delete_object, s3_delete_objects, s3_multipart_abort |
| admin | s3_create_bucket, s3_put_bucket_versioning, s3_put_bucket_cors, s3_put_bucket_policy, s3_delete_bucket_policy, s3_put_object_lock_configuration |
| admin + delete | s3_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. Это не биллинг.
Профиль включает московский 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 облака ещё требуют живой проверки.
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 — ошибка.
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 после согласия человека.
Пулы, эндпоинты и классы — в таблице совместимости; каждый факт, цены и ошибки с первоисточниками — в ресерче. Пул по умолчанию: ru-msk; регион SigV4 равен выбранному пулу. В профиле verified:false: проверка на versitygw не подтверждает API облака. Неподтверждённые сведения помечены [предположение]; цены в профиле не являются калькулятором биллинга.
Lifecycle, ACL, bucket tagging и object retention могут поддерживаться облаком, но эта версия не предоставляет инструментов для их настройки; данные профиля описывают совместимость S3 API.
Как выбрать 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
冒頭だけを表示しています。続きはリポジトリで読めます