Cloud.ru Container Apps MCP

A Model Context Protocol (MCP) server for interacting with Cloud.ru Container Apps and Artifact Registry.

What is MCP?

Model Context Protocol (MCP) is an open standard that enables seamless integration between AI assistants and external tools or data sources. It allows AI models to interact with your applications, services, and data in a secure and controlled manner.

With MCP, you can:

• Extend the capabilities of AI assistants beyond their training data
• Enable real-time interaction with live systems and APIs
• Provide contextually relevant information from your own data sources
• Execute complex workflows without leaving your AI assistant interface

Example Usage

Instead of manually performing tasks, you can simply ask your AI assistant:

"Build image, push and deploy to Cloud.ru Container Apps via MCP"

Your AI assistant, using this MCP server, can then:

1. Build a Docker image of your application
2. Push it to Cloud.ru Artifact Registry
3. Update your Container App with the new image
4. Report back the status of the deployment

All of this happens automatically through natural language commands, making complex DevOps tasks accessible to everyone.

Installation cloudru-containerapps-mcp to your system

go install github.com/Nick1994209/cloudru-containerapps-mcp/cmd/cloudru-containerapps-mcp@latest

or

go install ./cmd/cloudru-containerapps-mcp

docs/INSTALLATION.md

Add cloudru-containerapps-mcp to your IDE. For example VisualStudioCode or Cursor

Added MCP Setup

{
  "mcpServers": {
    "cloudru-containerapps-mcp": {
      "command": "cloudru-containerapps-mcp",
      "args": [],
      "env": {
        "CLOUDRU_KEY_ID": "********",
        "CLOUDRU_KEY_SECRET": "********",
        "CLOUDRU_PROJECT_ID": "********",
      },
      "timeout": 900,
      "disabledTools": []
    }
  }
}

docs/HOW_ADD_TO_IDE.md

The server will listen for JSON-RPC messages on stdin/stdout.

MCP Environment variables

docs/ENVIRONMENT_VARIABLES.md

Functions

cloudru_containerapps_description()

Returns usage instructions for this MCP.

cloudru_docker_login(registry_name)

Logs into the Cloud.ru Docker registry using the provided credentials.

Parameters:

• registry_name: Name of the registry (falls back to CLOUDRU_REGISTRY_NAME env var)

If login fails, you’ll need to:

1. Go to Cloud.ru Evolution Artifact Registry
2. Create a registry
3. Obtain access keys
4. See documentation: https://cloud.ru/docs/container-apps-evolution/ug/topics/tutorials__before-work

cloudru_docker_build_and_push(registry_name, repository_name, image_version, dockerfile_path, dockerfile_target, dockerfile_folder, show_commands)

Builds a Docker image and pushes it to Cloud.ru Artifact Registry.

Parameters:

• registry_name: Name of the registry (falls back to CLOUDRU_REGISTRY_NAME env var)