How heyjishh/cloudpanel-mcp works
CloudPanel MCP Server exposes server-management tools to AI clients, then executes remote commands over a persistent SSH connection. Its principal workflow is an MCP request, tool dispatch, SSH command execution on a managed VPS, and a result returned to the client. The README documents broad tool categories, including deployment and server installation; the excerpts show representative command execution, but not every handler. The CLI also configures client integrations, and the Python package forwards invocations to the npm CLI.
Main entry points: index.ts MCP Server · ssh.ts Persistent SSH · cli.ts Node CLI · cli.py Python Wrapper
Components 12
MCP Runtime
- MCP Server
src/index.ts - Persistent SSH
src/ssh.ts
VPS Management
- CloudPanel Tools
src/index.ts - Docker Tools
src/index.ts - Software Install
src/index.ts - Firewall & DNS
src/index.ts
Deployment & Operations
- Project Deploy
src/index.ts - Raw Command
src/index.ts
Client Setup
- Node CLI
src/cli.ts - Python Wrapper
python/src/cloudpanel_mcp/cli.py
Other components
- AI Client
- Managed VPS
Connections 17
- AI Client → MCP Server: sends MCP requests
README.md - MCP Server → AI Client: returns tool results
README.md - MCP Server → CloudPanel Tools: dispatches tools
README.md - MCP Server → Docker Tools: dispatches tools
README.md - MCP Server → Software Install: dispatches tools
README.md - MCP Server → Firewall & DNS: dispatches tools
README.md - MCP Server → Project Deploy: dispatches tool
README.md - MCP Server → Raw Command: dispatches tool
README.md - CloudPanel Tools → Persistent SSH: runs remote commands
src/index.ts - Docker Tools → Persistent SSH: runs remote commands
src/index.ts - Software Install → Persistent SSH: runs remote commands
src/index.ts - Project Deploy → Persistent SSH: runs remote commands
src/index.ts - Firewall & DNS → Persistent SSH: runs remote commands
src/index.ts - Raw Command → Persistent SSH: runs remote commands
src/index.ts - Persistent SSH → Managed VPS: executes SSH commands
README.md - Node CLI → MCP Server: starts server
src/cli.ts - Python Wrapper → Node CLI: forwards invocation
python/src/cloudpanel_mcp/cli.py