Skip to main content
Glama
heyjishh

cloudpanel-mcp

by heyjishh

CloudPanel MCP Server

50 tools to manage your CloudPanel VPS through any AI — Claude, Cursor, OpenCode, Gemini CLI, Kiro, Windsurf, Cline, and more.

npm Docker Hub PyPI GitHub

Quick Start

# 1. Install & configure for your AI tools (pick one):
npx cloudpanel-mcp install           # npm
docker run --rm heyyjish/cloudpanel-mcp:latest install   # Docker
pip install cloudpanel-mcp && cloudpanel-mcp install     # Python

# 2. Connect to your server (pick one):
#    SSH key:   ssh-copy-id root@your-server.com
#    Password:  Set CP_PASSWORD env var

# 3. Start using it
#    "Check what's installed on my server"
#    "Create a MySQL database called myapp"
#    "Install Docker and deploy my app"

Related MCP server: Coolify MCP Tools

50 Tools

Category

Tools

What you can do

CloudPanel (26)

cloudpanel_list_sites, cloudpanel_create_php_site, cloudpanel_create_nodejs_site, cloudpanel_create_python_site, cloudpanel_create_reverse_proxy_site, cloudpanel_create_static_site, cloudpanel_delete_site, cloudpanel_install_ssl, cloudpanel_list_ssl_certificates, cloudpanel_create_mysql_database, cloudpanel_create_mysql_user, cloudpanel_delete_mysql_database, cloudpanel_delete_mysql_user, cloudpanel_create_postgresql_database, cloudpanel_export_database, cloudpanel_import_database, cloudpanel_system_info, cloudpanel_system_update, cloudpanel_list_users, cloudpanel_create_user, cloudpanel_delete_user, cloudpanel_enable_2fa, cloudpanel_disable_2fa, cloudpanel_create_backup, cloudpanel_list_backups, cloudpanel_delete_backup

Sites · SSL · Databases · System · Users · Backups

Docker (10)

docker_list_containers, docker_deploy_compose, docker_container_logs, docker_stop_container, docker_restart_container, docker_list_images, docker_prune, docker_exec, docker_load_image, docker_login

Full Docker management · Registry login

Server Install (8)

server_install_docker, server_install_postgresql, server_install_nodejs, server_install_nginx, server_install_certbot, server_install_redis, server_install_mysql, server_software_status

One-shot installs with dryRun, method, version flags

Firewall & DNS (3)

server_firewall_status, server_firewall_allow_port, server_dns_check

Security · Networking

Deploy (1)

deploy_project

One-shot full stack deploy with method flag: docker, cloudpanel-reverse-proxy, cloudpanel-nodejs

Escape Hatch (1)

cloudpanel_raw_command

Run any shell command

Installation

Auto-install (all platforms)

npx cloudpanel-mcp install

Scans your machine and configures every AI tool it finds.

Manual per platform

npm

{
  "mcpServers": {
    "cloudpanel": {
      "command": "npx",
      "args": ["-y", "cloudpanel-mcp"],
      "env": {
        "CP_USER": "root",
        "CP_SSH_KEY": "/home/you/.ssh/id_ed25519",
        "CP_HOST": "your-server.com"
      }
    }
  }
}

Docker

{
  "mcpServers": {
    "cloudpanel": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-v", "/home/you/.ssh:/root/.ssh", "-e", "CP_HOST", "-e", "CP_USER", "-e", "CP_SSH_KEY", "heyyjish/cloudpanel-mcp:latest"],
      "env": {
        "CP_USER": "root",
        "CP_SSH_KEY": "/home/you/.ssh/id_ed25519",
        "CP_HOST": "your-server.com"
      }
    }
  }
}

pip

{
  "mcpServers": {
    "cloudpanel": {
      "command": "cloudpanel-mcp",
      "args": [],
      "env": {
        "CP_USER": "root",
        "CP_SSH_KEY": "/home/you/.ssh/id_ed25519",
        "CP_HOST": "your-server.com"
      }
    }
  }
}

Supported platforms

Tool

Config Path

Scope

OpenCode

~/.config/opencode/opencode.jsonc

global

Claude Desktop

claude_desktop_config.json

global

Claude Code

~/.claude/settings.json

global

Claude Code (local)

.claude/settings.local.json

local

Cursor

~/.cursor/mcp.json

global

Windsurf

~/.codeium/windsurf/mcp_config.json

global

Cline

~/.config/cline/mcp_settings.json

global

Gemini CLI

~/.config/gemini/config.json

global

Kiro

~/.config/kiro/config.json

global

Continue (VS Code)

~/.continue/config.json

global

VS Code MCP

.vscode/mcp.json

local

Codex CLI

~/.codex/config.json

global

Roo Code

~/.config/roo-code/mcp_settings.json or .roo/mcp.json

both

Aider

~/.aider.mcp.json or .aider.mcp.json

both

Cherry Studio

~/.config/cherry-studio/mcp.json

global

Enchanted (macOS)

~/Library/Application Support/com.enchant.MCP/config.json

global

JetBrains MCP

.idea/mcp.json or ~/.config/JetBrains/mcp.json

both

Environment Variables

Variable

Default

Description

CP_HOST

your-server.com

Server hostname or IP

CP_USER

root

SSH user

CP_SSH_KEY

~/.ssh/id_ed25519

SSH private key (omit for password auth)

CP_PASSWORD

SSH password (used when no key set)

CP_SSH_PORT

22

SSH port

Install Methods

npx cloudpanel-mcp install
# or install globally:
npm install -g cloudpanel-mcp && cloudpanel-mcp install

Docker

docker run --rm -v ~/.ssh:/root/.ssh heyyjish/cloudpanel-mcp:latest install
# Run as MCP server (for MCP configs that support Docker):
docker run --rm -i -v ~/.ssh:/root/.ssh \
  -e CP_HOST=your-server.com \
  heyyjish/cloudpanel-mcp:latest

pip / uv

pip install cloudpanel-mcp && cloudpanel-mcp install
# or with uv:
uv tool install cloudpanel-mcp && cloudpanel-mcp install

Architecture

├── src/
│   ├── index.ts      # MCP server — 50 tools registered
│   ├── cli.ts        # CLI entry — install, help, serve
│   └── ssh.ts        # Persistent SSH client with auto-reconnect
├── python/           # Python CLI wrapper (pip/uv)
├── Dockerfile        # Docker image
└── build/            # Compiled output

The server establishes a single persistent SSH connection with keepalive and auto-reconnect. No per-command connection overhead.

Deploying Apps

One-shot deploy

# Deploy with Docker (auto-installs Docker if missing)
deploy_project method=docker autoSsl=true frontendDomain=mysite.com

# Deploy behind CloudPanel reverse proxy
deploy_project method=cloudpanel-reverse-proxy autoSsl=true

# Deploy as CloudPanel-managed Node.js app
deploy_project method=cloudpanel-nodejs

Install prerequisites first

# Preview what would be installed
server_install_docker dryRun=true

# Actually install
server_install_docker method=official

# Install PostgreSQL 16
server_install_postgresql version=16

# Install Node.js 22 via nvm
server_install_nodejs method=nvm version=--lts

Prerequisites

  • A VPS running CloudPanel (v2+)

  • SSH access to the server as root

  • Node.js 18+ on the machine running the MCP

License

MIT

A
license - permissive license
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    B
    quality
    F
    maintenance
    Enables AI assistants to interact with Coolify for complete infrastructure management including applications, databases, servers, deployments, and team operations. Provides 100% API coverage with 64 tools for managing the entire Coolify ecosystem through natural language.
    Last updated
    18
    26
    6
    MIT
  • A
    license
    C
    quality
    D
    maintenance
    Enables AI agents to manage server infrastructure through the 1Panel API, including Docker containers, databases, and system monitoring. It provides tools for website management, file operations, and application deployment via natural language commands.
    Last updated
    15
    29
    MIT

View all related MCP servers

Related MCP Connectors

  • Security-first WordPress MCP server. 129 tools for Claude, ChatGPT, Gemini. Free on wp.org.

  • The agent-native cloud: database, functions, AI, storage, computers. 55 tools, one API key.

  • Let AI operate servers without SSH. Choose actions, approve risky changes, and audit every step.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/heyjishh/cloudpanel-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server