Skip to content

Androsh7/cloud_command

Repository files navigation

Cloud Command

Cloud Command is a web-based GUI for creating and managing multiple AWS EC2 instances. It takes roughly a minute and 30 seconds to create an instance and start the first interactive shell.

The built-in MCP server allows LLMs to connect to Cloud Command to create/destroy EC2s and run commands on them.

Main UI image

Shell image

Features

  • Create and destroy EC2 instances
  • Interactive terminal via the Web UI
  • File upload/download via SFTP
  • MCP server for AI agent integration

Setup

Cloud Command requires that the aws cli be installed and connected to an AWS account.

Args

usage: cloud_command [-h] [--version] [--host HOST] [--port PORT]
                     [--private-key-path PRIVATE_KEY_PATH]
                     [--public-key-path PUBLIC_KEY_PATH]
                     [--list-all] [--delete-all]

GUI for commanding multiple AWS assets

options:
  -h, --help            show this help message and exit
  --version             show program's version number and exit

uvicorn options:
  --host HOST           Uvicorn server IP, default: 127.0.0.1
  --port PORT           Uvicorn server port, default: 8080
  --private-key-path PRIVATE_KEY_PATH
                        Path to SSL private key file
  --public-key-path PUBLIC_KEY_PATH
                        Path to SSL certificate file

management options:
  --list-all            Lists all EC2s with a 'cloud_command' tag
  --delete-all          Destroys all EC2s with a 'cloud_command' tag

MCP integration

The MCP server is hosted at /api/mcp, these are the configs for claude:

{
  "mcpServers": {
    "cloud-command": {
      "type": "http",
      "url": "https://127.0.0.1:8080/api/mcp/"
    }
  }
}

NOTE: you may need to disable SSL verification when using self-signed certificates

Deployment

Linux: Download the .bin file, make it executable, then move it to /usr/bin/cloud_command to add it to your PATH:

chmod +x cloud_command.bin
sudo mv cloud_command.bin /usr/bin/cloud_command

Windows: Download the .exe file, move it to a permanent location (e.g. %APPDATA%\CloudCommand\), then add that directory to your system PATH:

  1. Open SettingsSystemAboutAdvanced system settings
  2. Click Environment Variables
  3. Under System variables, select Path and click Edit
  4. Click New and add the path to the directory containing cloud_command.exe
  5. Click OK to save

Build from source

# Create virtual environment
python3 -m venv .venv

# Activate (Linux)
source .venv/bin/activate
# Activate (Windows)
.venv/Scripts/activate.ps1

# Install dependencies
pip install .[dev]

# Run normally
python3 cloud_command/runner.py

# Build standalone executable
python3 build.py --help

About

Command and Control Web GUI and MCP Server for AWS EC2s

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors