适合谁
- 已经运行 Dokploy 并需要 API 自动化的团队
- 需要在 MCP 客户端中集中管理 Dokploy 资源的开发者
D
44FMRS · D
来源显示这是由 Dokploy 维护的官方 MCP 包，提供 stdio、Streamable HTTP 和传统 SSE 传输，并通过 API 令牌连接 Dokploy。由于服务器清单未缓存且来源未列出具体工具名称，未填充工具标识符。
Dokploy 官方 MCP 包，将 Dokploy API 端点作为 MCP 工具提供给兼容客户端。README 声称包含 508 个工具、覆盖 49 个类别，涉及项目、应用、Compose、数据库、服务器、Docker、集群、安全、备份、通知、Git 提供商、计费和其他 Dokploy 功能。
安装接入
使用 Node.js 18 或更高版本，并准备一个正在运行的 Dokploy 服务器。将提供的 JSON 配置加入 MCP 客户端配置，并设置 DOKPLOY_URL 和 DOKPLOY_API_KEY。也可使用 Bun、Deno、Docker 或 HTTP 模式。
claude_desktop_config.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"}}}}
选型与风险
不适合谁
- 没有 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 或更高版本
- 确认 DOKPLOY_URL 和 DOKPLOY_API_KEY 正确且 Dokploy 服务器正在运行
- 工具过多时使用 DOKPLOY_ENABLED_TAGS 按类别筛选
- 检查请求超时和重试相关环境变量
- 使用 @latest，并在需要时通过 MCP Inspector 检查连接
使用场景
通过 AI 客户端管理 Dokploy 项目和应用生命周期
操作数据库、备份、域名、通知和基础设施设置
通过 HTTP 或 stdio 将 Dokploy API 接入 MCP 客户端
支持客户端
Cursor完整支持
Windsurf完整支持
VS Code完整支持
Claude Code完整支持
Zed完整支持
Claude Desktop完整支持
BoltAI完整支持