← 返回目录

Dokploy MCP Server

官方

通过 MCP 管理 Dokploy 部署平台。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 315 / 438
Stars: ★ 401 非常热门
传输方式: stdio（本地进程） · Streamable HTTP · SSE
运行环境: Node.js 18+ · Docker
凭据: 需要 API Key / 凭据
许可证: 其他 / 未声明
最近提交: 33 天前

44FMRS · D

来源显示这是由 Dokploy 维护的官方 MCP 包，提供 stdio、Streamable HTTP 和传统 SSE 传输，并通过 API 令牌连接 Dokploy。由于服务器清单未缓存且来源未列出具体工具名称，未填充工具标识符。

最强项 · 安装易用性 13/20 最弱项 · 安全与权限 4/20

可靠性

8/20

安全与权限

4/20

维护活跃度

6/20

文档质量

13/20

安装易用性

13/20

查看各项评分依据

可靠性 8/20: README声称支持508个工具、stdio/HTTP传输、重试和错误处理，但服务器清单不可用，且没有可审查的源文件、CI或提交测试来验证初始化、工具列表握手、生成工具与实际行为的一致性。可靠的成功路径看似合理，但关键路径和边界错误均未被源材料证实，因此扣分。
安全与权限 4/20: 存在红线级风险：服务器暴露整个Dokploy API，包含删除、部署、远程基础设施、用户、密钥、账单和许可证等高影响操作；材料没有证明会在危险操作前要求确认，也没有显示最小权限或细粒度授权。API密钥通过环境变量传递，响应脱敏默认关闭，HTTP模式的认证与访问控制未说明。虽未见凭据窃取或恶意外传证据，但权限范围和确认机制不足，按红线标准给4分。
维护活跃度 6/20: 仓库未归档且有一定公开活动信号，但仅有星标和未关闭 issue 数，未提供发布记录、提交频率、依赖更新、CI、维护者责任或安全响应渠道证据。许可证字段为NOASSERTION，而README仅声明Apache License，授权状态仍需核实，因此仅给有限维护分。
文档质量 13/20: README覆盖多种客户端、Node/Bun/Deno/Docker安装方式、环境变量、传输端点、工具类别、过滤选项和基础排障，足以支持初步使用。扣分项包括清单缺失、未提供逐工具参数和权限说明、没有明确限制/成本/HTTP安全部署说明，也没有可验证的实现证据；大量能力描述仅来自README声明。
安装易用性 13/20: 提供npx、bunx、Deno、Docker及多个主流客户端配置示例，并说明运行时要求、必需环境变量和stdio/HTTP模式，主流场景的路径较清楚。扣分原因是仍需已有Dokploy实例和API令牌，HTTP生产部署的认证与TLS细节缺失，且没有源文件级执行验证；因此属于较易安装但仍有手工配置的方案。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据连接数据库

适合谁

已经运行 Dokploy 并需要 API 自动化的团队
需要在 MCP 客户端中集中管理 Dokploy 资源的开发者

不适合谁

没有 Dokploy 服务器或 API 令牌的用户
需要管理非 Dokploy 平台且不提供对应 API 的场景

所需权限

需要访问 Dokploy 服务器 URL
需要 Dokploy API 身份验证令牌
根据所调用的 API 操作，可能拥有创建、修改、部署、停止、删除和管理安全敏感资源的权限

风险与副作用

该服务器暴露 Dokploy API 的广泛操作范围，其中包括部署、停止、删除、密码和安全设置等可能产生破坏性影响的操作
API 响应可能包含环境变量、令牌、密码或其他敏感字段；可启用 DOKPLOY_REDACT_ENV=true 进行脱敏
应保护 DOKPLOY_API_KEY 以及通过 DOKPLOY_CUSTOM_HEADERS 提供的服务令牌

安装接入

准备工作

运行环境：Node.js 18+ · Docker

DOKPLOY_URL 必填你的 Dokploy 服务器地址，例如 https://your-dokploy-server.com。

DOKPLOY_API_KEY 必填密钥 Dokploy API 认证令牌，在运行中的 Dokploy 实例的用户设置中生成。

DOKPLOY_CUSTOM_HEADERS 可选密钥可选，附加到上游请求的 JSON 头，例如 Cloudflare Access 服务令牌；不可覆盖 x-api-key、content-type、accept。

其他可选配置项（8 个）

DOKPLOY_TOOL_PRESET 可选可选，预设工具集：all（默认）、minimal、core、deploy、databases、git。

DOKPLOY_ENABLED_TAGS 可选可选，逗号分隔的标签列表，只加载这些类别的工具。

DOKPLOY_DISABLED_TAGS 可选可选，逗号分隔的标签列表，从工具集中排除这些类别。

DOKPLOY_TIMEOUT 可选可选，请求超时毫秒数，默认 30000。

DOKPLOY_RETRY_ATTEMPTS 可选可选，重试次数，默认 3。

DOKPLOY_RETRY_DELAY 可选可选，重试间隔毫秒数，默认 1000。

DOKPLOY_REDACT_ENV 可选可选，是否在响应到达 MCP 客户端前隐去敏感字段，默认 true。

DOKPLOY_REDACT_FIELDS 可选可选，逗号分隔的需要隐去的响应字段名列表。

使用 Node.js 18 或更高版本，并准备一个正在运行的 Dokploy 服务器。将提供的 JSON 配置加入 MCP 客户端配置，并设置 DOKPLOY_URL 和 DOKPLOY_API_KEY。也可使用 Bun、Deno、Docker 或 HTTP 模式。

.cursor/mcp.json

{"mcpServers":{"dokploy-mcp":{"command":"npx","args":["-y","@dokploy/mcp"],"env":{"DOKPLOY_URL":"https://your-dokploy-server.com","DOKPLOY_API_KEY":"your-dokploy-api-token"}}}}

以 Cursor 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "dokploy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dokploy/mcp"
      ],
      "env": {
        "DOKPLOY_URL": "https://your-dokploy-server.com",
        "DOKPLOY_API_KEY": "your-dokploy-api-token"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add dokploy-mcp -e DOKPLOY_URL=https://your-dokploy-server.com -e DOKPLOY_API_KEY=your-dokploy-api-token -- npx -y @dokploy/mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中应看到 dokploy-mcp 提供的工具（默认 508 个，可用 DOKPLOY_TOOL_PRESET=minimal 减少）；用“列出我的项目”验证连接，若返回真实项目列表即说明 DOKPLOY_URL 与 DOKPLOY_API_KEY 配置正确。

常见排障

确认 Node.js 版本为 18 或更高版本
确认 DOKPLOY_URL 和 DOKPLOY_API_KEY 正确且 Dokploy 服务器正在运行
工具过多时使用 DOKPLOY_ENABLED_TAGS 按类别筛选
检查请求超时和重试相关环境变量
使用 @latest，并在需要时通过 MCP Inspector 检查连接

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我 Dokploy 服务器上的所有项目
创建一个新的 PostgreSQL 数据库并部署它
重新部署我的 application 分类下的某个应用并显示部署历史
检查我的服务器指标并清理 Docker

使用场景

通过 AI 客户端管理 Dokploy 项目和应用生命周期

操作数据库、备份、域名、通知和基础设施设置

通过 HTTP 或 stdio 将 Dokploy API 接入 MCP 客户端

支持客户端

Cursor

Windsurf

VS Code

Claude Code

Zed

Claude Desktop

BoltAI

依据项目文档列出，未经本站实测。

详细介绍

Dokploy 官方 MCP 包，将 Dokploy API 端点作为 MCP 工具提供给兼容客户端。README 声称包含 508 个工具、覆盖 49 个类别，涉及项目、应用、Compose、数据库、服务器、Docker、集群、安全、备份、通知、Git 提供商、计费和其他 Dokploy 功能。