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.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@cloudpanel-mcplist my websites on the server"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
This server cannot be installed
Maintenance
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
- AlicenseBqualityFmaintenanceEnables 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 updated18266MIT
- Alicense-qualityDmaintenanceEnables 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.Last updatedMIT
- 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.Last updated1529MIT
- Flicense-qualityDmaintenanceEnables AI assistants to manage Cloudways infrastructure, including servers, applications, monitoring, and security via the Cloudways API.Last updated
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.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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