Cloudways MCP Server

Servidor MCP para operar Cloudways desde Claude Code u otros clientes MCP.

Nota importante: la documentacion publica de Cloudways indica que API V1 llega a fin de vida el 31 de marzo de 2026. Este paquete sigue la estructura V1 del brief original, con CLOUDWAYS_API_BASE_URL configurable para poder migrar endpoints a V2 sin reescribir los tools.

Tools incluidos

• list-cloudways-servers

• list-cloudways-apps

• get-server-stats

• deploy-cloudways-app

• check-deployment-status

• get-cloudways-logs

• set-environment-variable

• list-environment-variables

• manage-ssl-certificate

• create-cloudways-backup

• list-cloudways-backups

• restart-cloudways-service

Related MCP server: mcp-cloudron

Instalacion local

npm install
npm run build

Configura credenciales:

cp .env.example .env

CLOUDWAYS_EMAIL=tu_email@example.com
CLOUDWAYS_API_TOKEN=tu_api_token
CLOUDWAYS_LOG_LEVEL=info
CLOUDWAYS_API_BASE_URL=https://api.cloudways.com/api/v1

Uso con Claude Code

Ejemplo de configuracion MCP:

{
  "mcpServers": {
    "cloudways": {
      "command": "node",
      "args": ["C:/Claude/empaya/cloudways-mcp-server/dist/index.js"],
      "env": {
        "CLOUDWAYS_EMAIL": "tu_email@example.com",
        "CLOUDWAYS_API_TOKEN": "tu_api_token"
      }
    }
  }
}

Tambien puedes ejecutar:

npm run dev

Seguridad

• No commitees .env ni tokens.

• list-environment-variables redacta valores sensibles.

• Los certificados SSL custom se pasan solo en la llamada MCP y no se escriben en disco.

Desarrollo

npm run typecheck
npm run build

Los endpoints estan centralizados en src/api/*. Si Cloudways V2 usa rutas distintas, ajusta esas clases y los nombres de tools pueden quedarse estables.