Skip to main content
Glama
deenesjakoruzh
jarciahdz111

Dokploy MCP Server

by jarciahdz111
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

Dokploy MCP 服务器

npm version license Node.js

MCP 服务器，提供 100% 的 Dokploy API 覆盖率 —— 从 Dokploy OpenAPI 规范自动生成的 463 个工具。直接从 Claude 管理项目、应用程序、数据库、Docker Compose 堆栈等。

要求

  • Node.js 18+ (使用 node -v 检查)

  • 拥有 API 访问权限的 Dokploy 账户

  • 从 Dokploy 仪表板的 Settings → API Keys 获取 API 密钥

快速入门

1. 安装

npm install -g @jarciahdz111/dokploy-mcp

或者直接运行而不安装：

npx @jarciahdz111/dokploy-mcp

2. 配置 Claude Desktop

创建或编辑您的 Claude Desktop 配置文件：

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Linux:

~/.config/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

添加此配置：

{
  "mcpServers": {
    "dokploy": {
      "command": "dokploy-mcp",
      "env": {
        "DOKPLOY_URL": "https://your-dokploy.com/api",
        "DOKPLOY_API_KEY": "your-api-key"
      }
    }
  }
}

3. 配置 Claude Code CLI (可选)

如果您使用 Claude Code CLI，请将其添加到 ~/.claude.json：

{
  "mcpServers": {
    "dokploy": {
      "command": "dokploy-mcp",
      "env": {
        "DOKPLOY_URL": "https://your-dokploy.com/api",
        "DOKPLOY_API_KEY": "your-api-key"
      }
    }
  }
}

4. 重启 Claude

重启 Claude Desktop 或您的终端。463 个 Dokploy 工具将可用。

环境变量

变量

描述

必需

默认值

DOKPLOY_URL

您的 Dokploy API URL (例如 https://cloud.dokploy.com/api)

是

—

DOKPLOY_API_KEY

从 Dokploy Settings → API Keys 获取的 API 密钥

是

—

REQUEST_TIMEOUT_MS

HTTP 请求超时时间（毫秒）

否

30000

DEBUG

设置为 1 以启用调试日志 (JSON 输出到 stderr)

否

—

可用工具

涵盖 42 个类别的 463 个工具。工具名称遵循 dokploy_{category}_{action} 的模式。

类别

工具数量

描述

admin

1

管理操作

ai

9

AI 驱动的功能

application

29

应用程序部署和管理

auditLog

1

审计日志访问

backup

11

备份配置和执行

bitbucket

7

Bitbucket 集成

certificate

4

SSL 证书管理

cluster

4

集群管理

compose

28

Docker Compose 堆栈操作

customRole

6

自定义角色权限

deployment

8

部署操作

destination

6

部署目标

docker

7

容器和镜像管理

domain

9

域名管理

environment

7

环境变量

gitea

8

Gitea 集成

gitProvider

2

通用 Git 提供商

github

6

GitHub 集成

gitlab

7

GitLab 集成

licenseKey

6

许可证管理

mariadb

14

MariaDB 数据库管理

mongo

14

MongoDB 数据库管理

mounts

6

卷挂载

mysql

14

MySQL 数据库管理

notification

38

Slack、电子邮件、Discord 通知

organization

11

组织管理

patch

12

补丁管理

port

4

端口配置

postgres

14

PostgreSQL 数据库管理

previewDeployment

4

预览部署

project

8

项目和环境管理

redis

14

Redis 缓存管理

redirects

4

重定向规则

registry

7

Docker 镜像仓库管理

rollback

2

部署回滚

schedule

6

定时任务

security

4

安全设置

server

16

服务器配置和管理

settings

49

服务器和应用程序设置

sso

10

SSO/OIDC/SAML 配置

sshKey

6

SSH 密钥管理

stripe

7

Stripe 计费

swarm

3

Docker Swarm 模式

user

20

用户和会话管理

volumeBackups

6

卷备份管理

whitelabeling

4

白标配置

使用示例

列出所有项目

dokploy_project_all

获取 Docker 容器

dokploy_docker_getContainers

获取应用程序详情

dokploy_application_one
// arguments: { applicationId: "your-application-id" }

部署应用程序

dokploy_application_deploy
// arguments: { applicationId: "your-application-id", to: "production" }

列出 PostgreSQL 数据库

dokploy_postgres_all

获取服务器状态

dokploy_settings_getDokployVersion

重启 Docker 容器

dokploy_docker_restartContainer
// arguments: { containerId: "your-container-id" }

本地开发

# Clone the repository
git clone https://github.com/jarciahdz111/dokploy-mcp.git
cd dokploy-mcp

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

# Test
node test-mcp.js

故障排除

"Unauthorized" 错误

您的 DOKPLOY_API_KEY 无效或已过期。

  1. 前往 Dokploy 仪表板的 Settings → API Keys

  2. 生成一个新的 API 密钥

  3. 更新 Claude Desktop 配置中的 DOKPLOY_API_KEY

  4. 重启 Claude

"Connection Refused" 错误

服务器无法连接到您的 Dokploy 实例。

  1. 验证 DOKPLOY_URL 是否正确（末尾必须包含 /api）

  2. 检查您的 Dokploy 服务器是否正在运行且可访问

  3. 如果位于企业防火墙后，请设置代理环境变量：

export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080

请求超时错误

请求耗时过长并已中止。

通过设置 REQUEST_TIMEOUT_MS 来增加超时时间：

{
  "mcpServers": {
    "dokploy": {
      "env": {
        "DOKPLOY_URL": "https://your-dokploy.com/api",
        "DOKPLOY_API_KEY": "your-api-key",
        "REQUEST_TIMEOUT_MS": "60000"
      }
    }
  }
}

启用调试日志

要查看详细的请求/响应日志：

{
  "mcpServers": {
    "dokploy": {
      "env": {
        "DOKPLOY_URL": "https://your-dokploy.com/api",
        "DOKPLOY_API_KEY": "your-api-key",
        "DEBUG": "1"
      }
    }
  }
}

调试输出将以 JSON 格式写入 stderr。

工作原理

此 MCP 服务器是从 Dokploy OpenAPI 规范自动生成的。当 Dokploy 发布 API 更新时，可以发布此包的新版本以更新工具覆盖范围 —— 无需手动编写工具。

服务器：

  1. 加载嵌入的 OpenAPI 规范 (1.4 MB, 463 个端点)

  2. 将每个端点转换为带有 Zod 验证输入模式的 MCP 工具

  3. 将 GET 请求路由为 tRPC 查询，将 POST 请求路由为 tRPC 变更

  4. 自动处理 tRPC 响应包装和错误解析

API 覆盖率

  • 100% 的 Dokploy API v0.28.8 端点

  • 463 个 MCP 工具

  • 42 个功能类别

  • 自动生成并与 API 规范同步

贡献

想要修改或扩展此 MCP 服务器？请参阅 CLAUDE.md 了解开发工作流程、架构概述和贡献指南。

许可证

MIT

Install Server
A
security – no known vulnerabilities
A
license - permissive license
C
quality - C tier

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jarciahdz111/dokploy-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server