____   ___  _  ______  _     _____   __  __  ____ ____  
|  _  / _ | |/ /  _ | |   / _   / / |  /  |/ ___|  _  
| | | | | | | ' /| |_) | |  | | |  V /  | |/| | |   | |_) |
| |_| | |_| | . |  __/| |__| |_| || |   | |  | | |___|  __/ 
|____/ ___/|_|__|   |________/ |_|   |_|  |_|____|_|    
                                                          

DOKPLOY MCP SERVER

The ultimate AI-powered interface to the Dokploy universe

A next-generation Model Context Protocol (MCP) server that bridges the gap between AI assistants and the powerful Dokploy infrastructure management platform. This middleware translates natural language into API calls, enabling seamless control over your entire cloud infrastructure through conversation.

CAPABILITIES MATRIX

DOMAIN	CAPABILITIES
DOCKER	Container management, configuration, lifecycle control
PROJECTS	Multi-project workflows, organization, role-based access
APPLICATIONS	Deployment, scaling, monitoring, logs
DATABASES	MySQL, PostgreSQL, MongoDB, Redis, MariaDB
SECURITY	SSH keys, certificates, registry credentials
NETWORKING	Domain management, endpoint testing, diagnostics
AI	Model deployment, inference, prompt management
MONITORING	Status checks, logs, metrics, diagnostics
ADMIN	User management, server setup, monitoring

THE FUTURE OF INFRASTRUCTURE MANAGEMENT

+-------------------+        +--------------------+        +------------------+
|                   |        |                    |        |                  |
|  AI ASSISTANTS    |------->|  DOKPLOY MCP       |------->|  CLOUD INFRA     |
| (GPT, Claude, etc)|<-------|  (You are here)    |<-------|  (The world)     |
|                   |        |                    |        |                  |
+-------------------+        +--------------------+        +------------------+

Seamlessly control your entire infrastructure through natural language. The Dokploy MCP Server acts as a universal translator between AI and your cloud systems.

INTELLIGENT FEATURES

• API Gateway: 200+ API endpoints unified under a single intelligent interface
• Context-Aware Processing: Understands complex, multi-step infrastructure operations
• Error Recovery: Sophisticated error handling with automatic recovery suggestions
• Security-First Design: Zero-trust architecture with comprehensive access controls
• Real-Time Updates: Streaming updates from long-running operations

QUICKSTART

# Clone the dimensional portal
git clone https://github.com/your-username/dokploy-mcp.git

# Enter the vortex
cd dokploy-mcp

# Install the quantum dependencies
npm install

# Compile the codebase
npm run build

# Launch the server on PORT 3000
npm start

Configure your dimensional gateway in .env:

DOKPLOY_API_URL=https://your-dokploy-instance.com/api
DOKPLOY_API_KEY=your-galactic-access-key
PORT=3000

UNIVERSAL API

Primary Interface

POST / HTTP/1.1
Content-Type: application/json

{
  "name": "dokploy_operation_name",
  "params": {
    "key1": "value1",
    "key2": "value2"
  }
}

Command Catalog

GET /tools HTTP/1.1

System Status

GET /health HTTP/1.1

OPERATION CAPABILITIES

Docker Control Module

• Container Lifecycle Management: Start, stop, restart, inspect
• Configuration Analysis: Deep inspection of container configurations
• Intelligent Matching: Find containers by app name or label patterns
• Stack Management: Handle complex multi-container applications

Project Orchestration

• Multi-Project Management: Create, update, duplicate, delete projects
• Environment Configuration: Manage environment variables securely
• Role-Based Access: Fine-grained permission controls
• Resource Allocation: Efficient resource distribution

Application Deployment System

• Continuous Deployment: Automated application deployment
• Scaling Operations: Scale applications up or down
• Environment Management: Control application environments
• Status Monitoring: Real-time application health checks

Database Command Center

• Multi-Engine Support: MySQL, PostgreSQL, MongoDB, Redis, MariaDB
• Instance Management: Create, configure, backup, restore
• Performance Tuning: Optimize database performance
• Security Controls: User management, password policies

Security Operations

• Certificate Management: Create, deploy, and rotate TLS certificates
• SSH Key Control: Generate and manage SSH keys
• Registry Credentials: Secure Docker registry integration
• User Access Control: Comprehensive user permission system

Network Intelligence

• Domain Management: Register, configure, validate domains
• Traffic Analysis: Endpoint testing and diagnostics
• Load Balancing: Distribute traffic efficiently
• SSL/TLS Automation: Automatic certificate provisioning

AI Operations

• Model Deployment: Deploy AI models within your infrastructure
• Inference Endpoints: Create and manage prediction APIs
• Model Management: Version control for AI models
• Resource Optimization: Efficiently allocate GPU/TPU resources

Diagnostics & Monitoring

• Log Analysis: Real-time log streaming and analysis
• Error Diagnosis: Automatic detection and diagnosis of issues
• Performance Metrics: Comprehensive system performance monitoring
• Health Checks: Continuous application and service health monitoring

System Administration

• User Management: Create, update, delete users and permissions
• Server Setup: Automated server provisioning and configuration
• Backup Systems: Scheduled backup and restore operations
• Alert Configuration: Set up notifications for system events

ADVANCED INTEGRATION

Windsurf AI Integration

{
  "mcpServers": {
    "dokploy-command-center": {
      "command": "node",
      "args": [
        "/path/to/dokploy-mcp/dist/index.js"
      ],
      "env": {
        "DOKPLOY_API_URL": "https://your-dokploy-instance.com/api",
        "DOKPLOY_API_KEY": "your-galactic-access-key",
        "PORT": "3000"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

CLI Access Portal

Communicate directly with the MCP server from your terminal:

curl -X POST http://localhost:3000 
  -H "Content-Type: application/json" 
  -d '{"name":"dokploy_list_projects","params":{}}'

DEVELOPER QUANTUM REALM

npm run dev -- quantum-testing.ts  # Test the fabric of reality

Directory Structure

/src
├── index.ts              # The singularity point
├── dokploy-client.ts     # The universal translator
└── quantum-connector.ts  # Spacetime fabric connector

JOIN THE FUTURE

The Dokploy MCP Server represents the next evolution in infrastructure management - where AI meets cloud operations to create something greater than the sum of its parts.

    /__/    DOKPLOY MCP: Where infrastructure
   /`    '   becomes conversation and cloud
 === 0  0 ===  management becomes effortless.
     --  /    
  /           
 /            
|            | 
   ||  ||  /  
  _oo__oo_/   

LICENSE

ISC - Free to use in your dimension

CONSOLIDATED TOOL ARCHITECTURE

The Dokploy MCP uses a powerful consolidated tool architecture that provides comprehensive functionality through a smaller set of high-level tools. This makes it easier for AI assistants to understand and utilize the full capabilities while reducing cognitive load.

Consolidated Tools

Instead of exposing 200+ individual API endpoints as separate tools, the MCP consolidates functionality into these powerful primary tools:

How It Works

Each consolidated tool follows a consistent action-based pattern:

{
  "name": "dokploy_application",
  "params": {
    "action": "restart",
    "applicationId": "app-123456"
  }
}

The server intelligently maps these high-level actions to the appropriate low-level API calls, handling parameter validation and providing helpful error messages.

Benefits

• Simplified Mental Model: LLMs can more easily understand and remember a small set of powerful tools
• Consistent Interface: All tools follow the same action-based pattern
• Reduced Token Usage: Fewer tool descriptions means more tokens available for reasoning
• Better Context Management: Easier to keep track of related operations within the same tool
• Enhanced Middleware Capabilities: The middleware layer can provide advanced features like caching, retries, and circuit breaking