dokploy-mcp

andradehenrique/dokploy-mcp

3.4

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

  1. project-all

    List all projects

  2. project-one

    Get project details

  3. project-create

    Create new projects

  4. project-update

    Update project configurations

  5. project-duplicate

    Duplicate projects with selective service copying

  6. project-remove

    Delete projects

  7. postgres-create

    Create new PostgreSQL databases

  8. postgres-one

    Get database details

  9. postgres-update

    Update database configurations

  10. postgres-remove

    Delete databases

  11. postgres-deploy

    Deploy databases

  12. postgres-start

    Start database instances

  13. postgres-stop

    Stop database instances

  14. postgres-reload

    Reload database configurations

  15. postgres-rebuild

    Rebuild database instances

  16. postgres-move

    Move databases between projects

  17. postgres-changeStatus

    Change database status

  18. postgres-saveExternalPort

    Configure external database ports

  19. postgres-saveEnvironment

    Manage database environment variables