____   ___  _  ______  _     _____   __  __  ____ ____  
|  _ \ / _ \| |/ /  _ \| |   / _ \ \ / / |  \/  |/ ___|  _ \ 
| | | | | | | ' /| |_) | |  | | | \ 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:

TOOL	DESCRIPTION	CAPABILITIES
dokploy_project	Project management	list, get, create, update, delete
dokploy_application	Application operations	list, get, create, update, delete, deploy, restart, stop, start
dokploy_server	Server management	list, get, create, update, delete, setup, validate, security
dokploy_docker	Docker container operations	list, restart, get_config, find_by_app, find_by_label, find_stack
dokploy_domain	Domain & certificate management	list, get, create, update, delete, validate, generate
dokploy_monitoring	Monitoring & logging	app_status, app_logs, server_metrics, setup
dokploy_diagnostics	Diagnostic utilities	test_endpoint, diagnose_502, check_security
dokploy_deployment	Deployment operations	deploy, redeploy, rollback
dokploy_database	Unified database interface	create, get, start, stop, deploy, update, delete, move, reload, rebuild
dokploy_backup	Backup management	create, get, list, update, delete, manual
dokploy_system	MCP system management	status, clear_cache, reset_circuit_breaker, metrics

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