# Vkcloud S3 MCP Ai Cli

> Vkcloud S3 MCP Ai Cli is an open-source MCP server for cloud and infrastructure. MCP server and CLI for VK Cloud Hotbox and Icebox storage in Claude Code and Cursor. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Linux, macOS, Windows
- **Repository:** https://github.com/stufently/vkcloud-s3-mcp-ai-cli
- **MCP Registry name:** io.github.stufently/vkcloud-s3-mcp-ai-cli
- **Categories:** [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

VK Cloud's object storage comes in Hotbox and Icebox flavours, and this server lets an agent check their metadata and fetch objects. It covers two pools: Moscow `ru-msk` (the default) and Kazakhstan `kz-ast`. Bucket tagging is disabled in this profile.

The README's example picks the pool of an existing bucket, reads an object's metadata with `stat`, totals a prefix with `du` and creates a short presigned link to hand over an archive. Larger transfers use multipart uploads or presigned URLs, and anything that changes data stays off until you enable write, delete or admin levels.

The `vkcloud-s3` binary is also a command-line client, and it can write MCP entries for Cursor, Claude Desktop, Codex and Claude Code. The authors say the profile and the cloud API still need live verification.

## Features

- **Two regional pools:** Switches between the Moscow ru-msk and Kazakhstan kz-ast pools.
- **Hotbox and Icebox metadata:** Reads object details for both storage flavours.
- **Short presigned links:** Creates time-limited download links for existing archives.
- **Prefix size totals:** Reports bounded usage figures for a prefix.
- **Layered permissions:** Read-only by default, with write, delete and admin enabled one at a time.
- **Built-in client installer:** Adds MCP configuration for several coding clients.

## Good for

- Check which pool holds a bucket and inspect an object
- Share a stored backup through a presigned link
- Measure how much a daily-backup prefix holds
- Restore an archive from VK Cloud to disk
- Keep an agent in read-only mode on production data

## Install

### Claude Code (Terminal)

```sh
claude mcp add vkcloud-s3-mcp-ai-cli --env VKCLOUD_S3_ACCESS_KEY_ID='<VKCLOUD_S3_ACCESS_KEY_ID>' --env VKCLOUD_S3_SECRET_ACCESS_KEY='<VKCLOUD_S3_SECRET_ACCESS_KEY>' -- docker run -i --rm -e VKCLOUD_S3_ACCESS_KEY_ID -e VKCLOUD_S3_SECRET_ACCESS_KEY ghcr.io/stufently/vkcloud-s3-mcp-ai-cli:0.1.1
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "vkcloud-s3-mcp-ai-cli": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VKCLOUD_S3_ACCESS_KEY_ID",
        "-e",
        "VKCLOUD_S3_SECRET_ACCESS_KEY",
        "ghcr.io/stufently/vkcloud-s3-mcp-ai-cli:0.1.1"
      ],
      "env": {
        "VKCLOUD_S3_ACCESS_KEY_ID": "<VKCLOUD_S3_ACCESS_KEY_ID>",
        "VKCLOUD_S3_SECRET_ACCESS_KEY": "<VKCLOUD_S3_SECRET_ACCESS_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "vkcloud-s3-mcp-ai-cli": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VKCLOUD_S3_ACCESS_KEY_ID",
        "-e",
        "VKCLOUD_S3_SECRET_ACCESS_KEY",
        "ghcr.io/stufently/vkcloud-s3-mcp-ai-cli:0.1.1"
      ],
      "env": {
        "VKCLOUD_S3_ACCESS_KEY_ID": "<VKCLOUD_S3_ACCESS_KEY_ID>",
        "VKCLOUD_S3_SECRET_ACCESS_KEY": "<VKCLOUD_S3_SECRET_ACCESS_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "vkcloud-s3-mcp-ai-cli": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VKCLOUD_S3_ACCESS_KEY_ID",
        "-e",
        "VKCLOUD_S3_SECRET_ACCESS_KEY",
        "ghcr.io/stufently/vkcloud-s3-mcp-ai-cli:0.1.1"
      ],
      "env": {
        "VKCLOUD_S3_ACCESS_KEY_ID": "<VKCLOUD_S3_ACCESS_KEY_ID>",
        "VKCLOUD_S3_SECRET_ACCESS_KEY": "<VKCLOUD_S3_SECRET_ACCESS_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "vkcloud-s3-mcp-ai-cli": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VKCLOUD_S3_ACCESS_KEY_ID",
        "-e",
        "VKCLOUD_S3_SECRET_ACCESS_KEY",
        "ghcr.io/stufently/vkcloud-s3-mcp-ai-cli:0.1.1"
      ],
      "env": {
        "VKCLOUD_S3_ACCESS_KEY_ID": "<VKCLOUD_S3_ACCESS_KEY_ID>",
        "VKCLOUD_S3_SECRET_ACCESS_KEY": "<VKCLOUD_S3_SECRET_ACCESS_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "vkcloud-s3-mcp-ai-cli": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VKCLOUD_S3_ACCESS_KEY_ID",
        "-e",
        "VKCLOUD_S3_SECRET_ACCESS_KEY",
        "ghcr.io/stufently/vkcloud-s3-mcp-ai-cli:0.1.1"
      ],
      "env": {
        "VKCLOUD_S3_ACCESS_KEY_ID": "<VKCLOUD_S3_ACCESS_KEY_ID>",
        "VKCLOUD_S3_SECRET_ACCESS_KEY": "<VKCLOUD_S3_SECRET_ACCESS_KEY>"
      }
    }
  }
}
```

## Tools

- `s3_list_buckets`: Lists the buckets the credentials can see.
- `s3_list_objects`: Lists objects under a prefix, up to 1000 per page.
- `s3_head_object`: Returns an object's metadata.
- `s3_get_object`: Reads an object inline, up to 262144 bytes.
- `s3_preview_object`: Returns a short preview of an object, up to 65536 bytes.
- `s3_presign_get`: Creates a presigned download URL.
- `s3_list_object_versions`: Lists versions of objects.
- `s3_list_multipart_uploads`: Lists multipart uploads in progress.
- `s3_list_parts`: Lists the parts of a multipart upload.
- `s3_get_bucket_config`: Reads a bucket's configuration.
- `s3_largest_objects`: Finds the largest objects under a prefix within a bounded scan.
- `s3_prefix_usage`: Reports aggregated usage per prefix in pages.
- `s3_unfinished_uploads`: Finds abandoned multipart uploads.
- `s3_download_file`: Downloads an object to the confined local file root.
- `s3_get_object_tagging`: Reads an object's tags.
- `s3_put_object`: Writes an object inline.
- `s3_create_folder`: Creates a folder marker.
- `s3_copy_object`: Copies an object.
- `s3_presign_put`: Creates a presigned upload URL.
- `s3_multipart_create`: Starts a multipart upload.
- `s3_multipart_presign_part`: Presigns one part of a multipart upload.
- `s3_multipart_complete`: Completes a multipart upload.
- `s3_upload_file`: Uploads a file from the confined local file root.
- `s3_put_object_tagging`: Writes an object's tags.
- `s3_delete_object`: Deletes one object.
- `s3_delete_objects`: Deletes several objects.
- `s3_multipart_abort`: Aborts a multipart upload.
- `s3_create_bucket`: Creates a bucket.
- `s3_put_bucket_versioning`: Sets bucket versioning.
- `s3_put_bucket_cors`: Sets bucket CORS rules.
- `s3_put_bucket_policy`: Sets a bucket policy.
- `s3_delete_bucket_policy`: Removes a bucket policy.
- `s3_put_object_lock_configuration`: Sets the Object Lock configuration.
- `s3_delete_bucket`: Deletes a bucket.

## FAQ

### Which pools are included?

ru-msk (Moscow, the default) and kz-ast (Kazakhstan).

### Does it support bucket tagging?

No; bucket tagging is disabled in this profile.

### Can it change data?

Only after you enable write, delete or admin levels; read is the default.

### How does it handle credentials?

Flags win over environment variables, which win over a credentials file created with 0600 permissions.

### Is Vkcloud S3 MCP Ai Cli free?

Yes. Vkcloud S3 MCP Ai Cli is open source, so you can use and self-host it for free.

### How do I add Vkcloud S3 MCP Ai Cli to Claude Code?

Run this command in your terminal: claude mcp add vkcloud-s3-mcp-ai-cli --env VKCLOUD_S3_ACCESS_KEY_ID='<VKCLOUD_S3_ACCESS_KEY_ID>' --env VKCLOUD_S3_SECRET_ACCESS_KEY='<VKCLOUD_S3_SECRET_ACCESS_KEY>' -- docker run -i --rm -e VKCLOUD_S3_ACCESS_KEY_ID -e VKCLOUD_S3_SECRET_ACCESS_KEY ghcr.io/stufently/vkcloud-s3-mcp-ai-cli:0.1.1

### What are the best alternatives to Vkcloud S3 MCP Ai Cli?

The closest alternatives to Vkcloud S3 MCP Ai Cli are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/vkcloud-s3-mcp-ai-cli
