Servidor MCP de Dokploy

Servidor MCP que proporciona una cobertura del 100% de la API de Dokploy: 463 herramientas generadas automáticamente a partir de la especificación OpenAPI de Dokploy. Gestiona proyectos, aplicaciones, bases de datos, stacks de Docker Compose y más directamente desde Claude.

Requisitos

• Node.js 18+ (verifícalo con node -v)

• Una cuenta de Dokploy con acceso a la API

• Clave de API desde Settings → API Keys en tu panel de control de Dokploy

Inicio rápido

1. Instalación

npm install -g @jarciahdz111/dokploy-mcp

O ejecútalo sin instalar:

npx @jarciahdz111/dokploy-mcp

2. Configurar Claude Desktop

Crea o edita tu archivo de configuración de Claude Desktop:

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Linux:

~/.config/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Agrega esta configuración:

{
  "mcpServers": {
    "dokploy": {
      "command": "dokploy-mcp",
      "env": {
        "DOKPLOY_URL": "https://your-dokploy.com/api",
        "DOKPLOY_API_KEY": "your-api-key"
      }
    }
  }
}

3. Configurar Claude Code CLI (opcional)

Si utilizas la CLI de Claude Code, añade esto a ~/.claude.json:

{
  "mcpServers": {
    "dokploy": {
      "command": "dokploy-mcp",
      "env": {
        "DOKPLOY_URL": "https://your-dokploy.com/api",
        "DOKPLOY_API_KEY": "your-api-key"
      }
    }
  }
}

4. Reiniciar Claude

Reinicia Claude Desktop o tu terminal. Las 463 herramientas de Dokploy estarán disponibles.

Variables de entorno

Herramientas disponibles

463 herramientas en 42 categorías. Los nombres de las herramientas siguen el patrón dokploy_{categoría}_{acción}.

Ejemplos de uso

Listar todos los proyectos

dokploy_project_all

Obtener contenedores Docker

dokploy_docker_getContainers

Obtener detalles de la aplicación

dokploy_application_one
// arguments: { applicationId: "your-application-id" }

Desplegar una aplicación

dokploy_application_deploy
// arguments: { applicationId: "your-application-id", to: "production" }

Listar bases de datos PostgreSQL

dokploy_postgres_all

Obtener estado del servidor

dokploy_settings_getDokployVersion

Reiniciar un contenedor Docker

dokploy_docker_restartContainer
// arguments: { containerId: "your-container-id" }

Desarrollo local

# Clone the repository
git clone https://github.com/jarciahdz111/dokploy-mcp.git
cd dokploy-mcp

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

# Test
node test-mcp.js

Solución de problemas

Error "Unauthorized"

Tu DOKPLOY_API_KEY no es válida o ha caducado.

1. Ve a Settings → API Keys en tu panel de control de Dokploy

2. Genera una nueva clave de API

3. Actualiza la DOKPLOY_API_KEY en tu configuración de Claude Desktop

4. Reinicia Claude

Error "Connection Refused"

El servidor no puede comunicarse con tu instancia de Dokploy.

1. Verifica que DOKPLOY_URL sea correcta (debe incluir /api al final)

2. Comprueba que tu servidor Dokploy esté en ejecución y sea accesible

3. Si estás detrás de un firewall corporativo, establece las variables de entorno del proxy:

export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080

Error "Request Timeout"

La solicitud tardó demasiado y fue abortada.

Aumenta el tiempo de espera configurando REQUEST_TIMEOUT_MS:

{
  "mcpServers": {
    "dokploy": {
      "env": {
        "DOKPLOY_URL": "https://your-dokploy.com/api",
        "DOKPLOY_API_KEY": "your-api-key",
        "REQUEST_TIMEOUT_MS": "60000"
      }
    }
  }
}

Habilitar registro de depuración

Para ver registros detallados de solicitud/respuesta:

{
  "mcpServers": {
    "dokploy": {
      "env": {
        "DOKPLOY_URL": "https://your-dokploy.com/api",
        "DOKPLOY_API_KEY": "your-api-key",
        "DEBUG": "1"
      }
    }
  }
}

La salida de depuración se escribe en stderr como JSON.

Cómo funciona

Este servidor MCP se genera automáticamente a partir de la especificación OpenAPI de Dokploy. Cuando Dokploy lanza una actualización de la API, se puede publicar una nueva versión de este paquete con la cobertura de herramientas actualizada, sin necesidad de escribir herramientas manualmente.

El servidor:

1. Carga la especificación OpenAPI integrada (1.4 MB, 463 endpoints)

2. Convierte cada endpoint en una herramienta MCP con un esquema de entrada validado por Zod

3. Enruta las solicitudes GET como consultas tRPC y las solicitudes POST como mutaciones tRPC

4. Maneja automáticamente el envoltorio de respuestas tRPC y el análisis de errores

Cobertura de la API

• 100% de los endpoints de la API de Dokploy v0.28.8

• 463 herramientas MCP

• 42 categorías funcionales

• Generado y sincronizado automáticamente con la especificación de la API

Contribución

¿Quieres modificar o ampliar este servidor MCP? Consulta CLAUDE.md para conocer el flujo de trabajo de desarrollo, la descripción general de la arquitectura y las pautas de contribución.

Licencia

MIT