cloudpanel-mcp-server
Allows issuing Let's Encrypt certificates for sites in one call, or installing a custom certificate instead.
Provides tools to list, view, add, import and delete NGINX vhost templates on the CloudPanel 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.
What it does
Every tool is one documented clpctl command; the full list, with parameters, is in docs/TOOLS.md.
Related MCP server: vps-mcp-server
Built to be safe
How each layer works, and what no tool can promise: docs/SECURITY-MODEL.md.
How it works
Quick start
You need: a CloudPanel v2 server (root or sudo, once, for the setup), Node.js 22 or newer and ssh on your computer, and any MCP client.
Replace 203.0.113.10 with your server's address.
1. Make a key for the assistant (on your computer)
ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519_cloudpanel -N "" -C ai-assistant2. Prepare the server in one command (to read the script first: npx -y cloudpanel-mcp-server@0.1.0 --print-server-setup | less)
npx -y cloudpanel-mcp-server@0.1.0 --print-server-setup \
| ssh root@203.0.113.10 "bash -s -- --key '$(cat ~/.ssh/id_ed25519_cloudpanel.pub)' --allow write"It creates a dedicated account with one sudo rule (clpctl only), installs the gate, locks your key to it and tests everything. It touches no site and
no setting. Sudo user instead of root, or rather do it by hand? See docs/SETUP.md.
3. Save the connection (on your computer)
npx -y cloudpanel-mcp-server@0.1.0 --init --host 203.0.113.10 --allow writeIt writes the configuration and checks the connection: ok - sudo -n /usr/bin/clpctl answered with 28 commands. Leave out --allow write to start read-only.
4. Connect your AI agent: every client runs the same command, with no settings.
# Claude Code
claude mcp add --transport stdio --scope user cloudpanel -- npx -y cloudpanel-mcp-server@0.1.0
# Codex (then give the first start more time: docs/CLIENTS.md#codex)
codex mcp add cloudpanel -- npx -y cloudpanel-mcp-server@0.1.0
# Gemini CLI
gemini mcp add -s user cloudpanel npx -- -y cloudpanel-mcp-server@0.1.0
# OpenCode
opencode mcp add cloudpanel --global -- npx -y cloudpanel-mcp-server@0.1.0
# Pi
pi mcp add cloudpanel -- npx -y cloudpanel-mcp-server@0.1.0
# GitHub Copilot CLI
copilot mcp add cloudpanel -- npx -y cloudpanel-mcp-server@0.1.0VS Code, Cursor, Claude Desktop, Windsurf, Kiro, Cline, Zed, Goose and others take one small block: docs/CLIENTS.md.
5. Try it: "Call clp_server_info and tell me what my CloudPanel server offers."
Changes need a client that can show an approval form: Claude Code, Codex, OpenCode 2.x, Cursor, VS Code, Copilot CLI, Goose and Kiro. In the others (Gemini CLI, Pi, Claude Desktop, Windsurf, Cline, Zed, ...) the assistant can look at everything and gives you the exact command for each change.Details.
Ifnpx cannot find the package (before the first release is on npm), build it once: git clone this repository, npm ci && npm run build, and use
node /absolute/path/to/dist/index.js in place of npx -y cloudpanel-mcp-server@0.1.0.
Documentation
script options, sudo users, setting up by hand, the inventory helper, removing it | |
every client, start timeouts, which ones can approve changes | |
several servers, protected sites, every setting and variable | |
approval, the gate, layers of protection, honest limits | |
all 32 tools and their parameters | |
what an error means and how to fix it | |
what has been tested on a real CloudPanel, and the independent review | |
Status
Pre-release (0.1.x). Every tool family has run against a real CloudPanel 2.5.4, except the panel's Basic Auth and release-channel switches, the two
site-user commands and the inventory helper, which have run only against a strict clpctl simulator (details).
Unofficial. This project is not affiliated with, endorsed by or sponsored by CloudPanel or its vendor. "CloudPanel" is a trademark of its owner; the name only says what this software works with. Licensed under Apache-2.0.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Let AI operate servers without SSH. Choose actions, approve risky changes, and audit every step.
Work on your own computers from Claude or ChatGPT: run commands, edit and search files.
Connect AI assistants to explicitly paired computers, servers, and VMs for permitted remote actions.
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables Claude AI to execute commands across multiple remote servers via SSH, with TOTP 2FA authentication and 29 built-in MCP tools for server management.-
- FlicenseAqualityDmaintenanceGives AI assistants full control over a VPS via SSH, enabling command execution, file management, service control, Docker and firewall management.96-
- AlicenseNot gradedqualityDmaintenanceProvides 50 tools to manage a CloudPanel VPS through AI assistants, covering sites, databases, Docker, server software, firewall, DNS, and one-shot deployments.30 npm4MIT
- AlicenseBqualityCmaintenanceEnables MCP-compatible AI assistants to inspect and manage local or remote servers in plain language, covering system health, Docker containers, services, ports, disks, scoped files, and read-only database queries over key-only SSH. Write actions such as container restarts, file edits, and allowlisted dev commands require client approval.14MIT