Skip to main content
Glama
cloudpanel-mcp-server

cloudpanel-mcp-server

by dasocreative

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-assistant

2. 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 write

It 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.0

VS 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."

NOTE

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.

TIP

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

Setup in detail

script options, sudo users, setting up by hand, the inventory helper, removing it

Connect your AI agent

every client, start timeouts, which ones can approve changes

Configuration

several servers, protected sites, every setting and variable

Security model

approval, the gate, layers of protection, honest limits

Tools

all 32 tools and their parameters

Troubleshooting

what an error means and how to fix it

Live verification · Security review

what has been tested on a real CloudPanel, and the independent review

Contributing · Report a vulnerability · Changelog

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…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude AI to execute commands across multiple remote servers via SSH, with TOTP 2FA authentication and 29 built-in MCP tools for server management.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 50 tools to manage a CloudPanel VPS through AI assistants, covering sites, databases, Docker, server software, firewall, DNS, and one-shot deployments.
      30 npm
      4
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables 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.
      14
      MIT