andradehenrique/dokploy-mcp
If you are the rightful owner of dokploy-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The Dokploy MCP Server is a tool that exposes Dokploy functionalities as tools consumable via the Model Context Protocol (MCP), allowing MCP-compatible clients to interact with a Dokploy server programmatically.
The Dokploy MCP Server is designed to facilitate seamless interaction between MCP-compatible clients and the Dokploy server. It provides a robust interface for managing projects, applications, and databases through a comprehensive set of tools. The server supports multiple transport modes, including stdio and HTTP, to cater to different deployment scenarios. With a focus on project and application management, the Dokploy MCP Server integrates with various Git providers and offers extensive configuration options for builds, deployments, and monitoring. The server is built using Node.js and TypeScript, ensuring type-safe operations and robust error handling. It includes semantic annotations for tools, enhancing the understanding and usability for MCP clients. The server architecture supports a wide range of operations, making it a versatile solution for managing Dokploy environments.
Features
- Comprehensive Tool Coverage: Offers 43 tools for project, application, and database management.
- Multiple Transport Modes: Supports stdio and HTTP for flexible deployment.
- Git Provider Integrations: Compatible with GitHub, GitLab, Bitbucket, Gitea, and custom Git repositories.
- Type-Safe Operations: Built with Node.js and TypeScript for robust error handling and type safety.
- Semantic Tool Annotations: Includes annotations for enhanced MCP client understanding.
Usages
usage with Cursor
{ "mcpServers": { "dokploy-mcp": { "command": "npx", "args": ["-y", "@ahdev/dokploy-mcp"], "env": { "DOKPLOY_URL": "https://your-dokploy-server.com/api", "DOKPLOY_API_KEY": "your-dokploy-api-token" } } } }
usage with Bun
{ "mcpServers": { "dokploy-mcp": { "command": "bunx", "args": ["-y", "@ahdev/dokploy-mcp"], "env": { "DOKPLOY_URL": "https://your-dokploy-server.com/api", "DOKPLOY_API_KEY": "your-dokploy-api-token" } } } }
usage with Deno
{ "mcpServers": { "dokploy-mcp": { "command": "deno", "args": ["run", "--allow-env", "--allow-net", "npm:@ahdev/dokploy-mcp"], "env": { "DOKPLOY_URL": "https://your-dokploy-server.com/api", "DOKPLOY_API_KEY": "your-dokploy-api-token" } } } }
usage with Windsurf
{ "mcpServers": { "dokploy-mcp": { "command": "npx", "args": ["-y", "@ahdev/dokploy-mcp"], "env": { "DOKPLOY_URL": "https://your-dokploy-server.com/api", "DOKPLOY_API_KEY": "your-dokploy-api-token" } } } }
usage with VS Code
{ "servers": { "dokploy-mcp": { "type": "stdio", "command": "npx", "args": ["-y", "@ahdev/dokploy-mcp"], "env": { "DOKPLOY_URL": "https://your-dokploy-server.com/api", "DOKPLOY_API_KEY": "your-dokploy-api-token" } } } }
usage with Zed
{ "context_servers": { "dokploy-mcp": { "command": { "path": "npx", "args": ["-y", "@ahdev/dokploy-mcp"] }, "settings": { "DOKPLOY_URL": "https://your-dokploy-server.com/api", "DOKPLOY_API_KEY": "your-dokploy-api-token" } } } }
usage with Claude Desktop
{ "mcpServers": { "dokploy-mcp": { "command": "npx", "args": ["-y", "@ahdev/dokploy-mcp"], "env": { "DOKPLOY_URL": "https://your-dokploy-server.com/api", "DOKPLOY_API_KEY": "your-dokploy-api-token" } } } }
usage with BoltAI
{ "mcpServers": { "dokploy-mcp": { "command": "npx", "args": ["-y", "@ahdev/dokploy-mcp"], "env": { "DOKPLOY_URL": "https://your-dokploy-server.com/api", "DOKPLOY_API_KEY": "your-dokploy-api-token" } } } }
usage with Docker stdio
{ "mcpServers": { "dokploy-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "DOKPLOY_URL=https://your-dokploy-server.com/api", "-e", "DOKPLOY_API_KEY=your_token_here", "dokploy-mcp" ] } } }
usage with Windows
{ "mcpServers": { "dokploy-mcp": { "command": "cmd", "args": ["/c", "npx", "-y", "@ahdev/dokploy-mcp"], "env": { "DOKPLOY_URL": "https://your-dokploy-server.com/api", "DOKPLOY_API_KEY": "your-dokploy-api-token" } } } }
Tools
project-all
List all projects
project-one
Get project details
project-create
Create new projects
project-update
Update project configurations
project-duplicate
Duplicate projects with selective service copying
project-remove
Delete projects
postgres-create
Create new PostgreSQL databases
postgres-one
Get database details
postgres-update
Update database configurations
postgres-remove
Delete databases
postgres-deploy
Deploy databases
postgres-start
Start database instances
postgres-stop
Stop database instances
postgres-reload
Reload database configurations
postgres-rebuild
Rebuild database instances
postgres-move
Move databases between projects
postgres-changeStatus
Change database status
postgres-saveExternalPort
Configure external database ports
postgres-saveEnvironment
Manage database environment variables