Dokploy MCP Server

What is Dokploy MCP Server?

Dokploy MCP Server exposes Dokploy functionalities as tools consumable via the Model Context Protocol (MCP). It allows MCP-compatible clients (e.g., AI models, other applications) to interact with your Dokploy server programmatically. The server provides 43 tools organized into project, application, and database management. This project is discontinued and has been moved to the official Dokploy organization repository (https://github.com/Dokploy/mcp).

How to use Dokploy MCP Server?

Install using npx -y @ahdev/dokploy-mcp (or with Bun, Deno, or Docker). Set the environment variables DOKPLOY_URL (your Dokploy server API URL) and DOKPLOY_API_KEY (your API token). Configure the server in your MCP client (Cursor, VS Code, Zed, Claude Desktop, etc.) by adding a JSON configuration block specifying the command and environment variables. The server runs in stdio mode by default; use --http or MCP_TRANSPORT=http to enable HTTP mode.

Key features of Dokploy MCP Server

• 43 tools for Dokploy project, application, and database management
• Supports multiple Git providers: GitHub, GitLab, Bitbucket, Gitea, Git, and Docker
• Build type configuration (Dockerfile, Heroku, Nixpacks, etc.)
• Environment variable and build argument management
• Two transport modes: stdio (default) and HTTP (Streamable HTTP + legacy SSE)
• Docker deployment support with both stdio and HTTP modes

Use cases of Dokploy MCP Server

• Manage Dokploy projects and applications through AI-powered chat interfaces
• Automate deployment workflows with lifecycle commands (deploy, stop, reload)
• Duplicate projects with selective service copying
• Configure and update application build settings and environment variables
• Monitor application health and integrate with monitoring tools

FAQ from Dokploy MCP Server

What are the requirements to run Dokploy MCP Server?

Node.js >= v18.0.0 (or Docker), an MCP-compatible client (Cursor, VS Code, Claude Desktop, etc.), and a running Dokploy server instance.

How do I configure Dokploy MCP Server?

Set the environment variables DOKPLOY_URL (your Dokploy server API URL) and DOKPLOY_API_KEY (your API authentication token) in the MCP client configuration file.

What transport modes does Dokploy MCP Server support?

Stdio mode (default) for desktop applications and HTTP mode (Streamable HTTP + legacy SSE) for web applications. The HTTP server listens on port 3000 by default.

Is Dokploy MCP Server still maintained?

No. This repository is discontinued and has been moved to the official Dokploy organization. Please migrate to the new repository at https://github.com/Dokploy/mcp for updates and support.

How can I migrate to the official repository?

Follow the migration guide referenced in the README (MIGRATION.md) and switch to the official repository at https://github.com/Dokploy/mcp.