cloudpanel-mcp
Provides tools for managing Docker containers, images, and deployments on a CloudPanel VPS.
Allows creation, deletion, and management of MySQL databases and users.
Enables installation and management of Nginx as part of server setup.
Supports creating Node.js sites and installing Node.js on the server.
Allows creation, deletion, and management of PostgreSQL databases and installation.
Supports creating Python sites and installing Python on the server.
Enables installation and management of Redis on the server.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
CloudPanel MCP Server
50 tools to manage your CloudPanel VPS through any AI — Claude, Cursor, OpenCode, Gemini CLI, Kiro, Windsurf, Cline, and more.
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) |
| Sites · SSL · Databases · System · Users · Backups |
Docker (10) |
| Full Docker management · Registry login |
Server Install (8) |
| One-shot installs with |
Firewall & DNS (3) |
| Security · Networking |
Deploy (1) |
| One-shot full stack deploy with |
Escape Hatch (1) |
| Run any shell command |
Installation
Auto-install (all platforms)
npx cloudpanel-mcp installScans 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 |
| global |
Claude Desktop |
| global |
Claude Code |
| global |
Claude Code (local) |
| local |
Cursor |
| global |
Windsurf |
| global |
Cline |
| global |
Gemini CLI |
| global |
Kiro |
| global |
Continue (VS Code) |
| global |
VS Code MCP |
| local |
Codex CLI |
| global |
Roo Code |
| both |
Aider |
| both |
Cherry Studio |
| global |
Enchanted (macOS) |
| global |
JetBrains MCP |
| both |
Environment Variables
Variable | Default | Description |
|
| Server hostname or IP |
|
| SSH user |
|
| SSH private key (omit for password auth) |
| — | SSH password (used when no key set) |
|
| SSH port |
Install Methods
npm (recommended)
npx cloudpanel-mcp install
# or install globally:
npm install -g cloudpanel-mcp && cloudpanel-mcp installDocker
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:latestpip / uv
pip install cloudpanel-mcp && cloudpanel-mcp install
# or with uv:
uv tool install cloudpanel-mcp && cloudpanel-mcp installArchitecture
├── 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 outputThe 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-nodejsInstall 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=--ltsPrerequisites
A VPS running CloudPanel (v2+)
SSH access to the server as root
Node.js 18+ on the machine running the MCP
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Related MCP Connectors
Manage Vozora VPS servers, SSH keys, firewalls, DNS and usage from an AI agent.
Manage VeriTeknik servers, DNS, backups and support tickets from your AI assistant.
Deploy and manage your apps, databases, storage, and scheduled jobs from your AI agent
Manage your WordPress site from ChatGPT or Claude: posts, WooCommerce, SEO, images and upkeep.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables 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.1811 npm6MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Coolify infrastructure including servers, applications, databases, deployments, and 80+ one-click services through 98 comprehensive tools for both cloud and self-hosted instances.MIT
- AlicenseCqualityDmaintenanceEnables 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.1535 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Cloudways infrastructure, including servers, applications, monitoring, and security via the Cloudways API.-