Dokploy MCP

@vibetools/dokploy-mcp

适用于 Dokploy 的 MCP 服务，可与 Codex、Cursor、Claude Code 和 Claude Desktop 顺畅协作。

前台提供 3 个工具，底层涵盖数百项 Dokploy 操作。减少架构开销，专注实际部署。

大多数 MCP 服务把你的上下文窗口当成免费垃圾场。这个服务从 search、execute 和 list_profiles 入手，再按需扩展。

这能带来：

• 精简的默认接口，而非数百个原始端点工具
• 底层生成的广泛 Dokploy 覆盖能力
• 面向部署、compose、日志、域名、数据库和配置档案的实际工作流
• 同一个包同时支持本地 stdio 和托管 HTTP 元数据

想看证据，而不是听一通推销？请从 docs/live-e2e-proof.md 开始。

当前数据一览

• 固定目录中的生成式 API 操作：544
• 生成标签：50
• 默认公开 MCP 工具：3（search、execute、list_profiles）
• 当前预算检查中的默认 tools/list 占用：约 1,681 个令牌（6,723 字节）
• 相比传统的每个端点对应一个工具的基准（92,354 个令牌），减少：98.2%

	传统的每个端点对应一个工具的基准	当前 Code Mode 默认值
发送的工具定义	约 92,354 个令牌	约 1,681 个令牌
公开 MCP 工具	数百个端点架构	3 个
上下文窗口开销	大量架构转储	精简且固定的接口

快速开始

从 Dokploy Settings > Profile > API/CLI 获取 API 密钥。

基于环境变量进行设置，请从 .env.example 开始。

如果你的客户端使用 JSON 格式的 MCP 配置，请使用以下完整配置块：

{
  "mcpServers": {
    "dokploy": {
      "command": "npx",
      "args": ["@vibetools/dokploy-mcp"],
      "env": {
        "DOKPLOY_URL": "https://panel.example.com",
        "DOKPLOY_API_KEY": "dokp_..."
      }
    }
  }
}

如果你的客户端通过命令行管理 MCP：

# Codex
codex mcp add dokploy \
  --env DOKPLOY_URL=https://panel.example.com \
  --env DOKPLOY_API_KEY=dokp_... \
  -- npx @vibetools/dokploy-mcp

# Claude Code
claude mcp add --transport stdio \
  -e DOKPLOY_URL=https://panel.example.com \
  -e DOKPLOY_API_KEY=dokp_... \
  dokploy -- npx @vibetools/dokploy-mcp

已经通过 Dokploy CLI 或本地 dokploy-mcp 配置完成身份验证？

你可能完全不需要环境变量配置块。

使用多个 Dokploy 组织？

保留一个精简的 MCP 服务，并通过 DOKPLOY_PROFILES_JSON 配置配置档案：

{
  "mcpServers": {
    "dokploy": {
      "command": "npx",
      "args": ["@vibetools/dokploy-mcp"],
      "env": {
        "DOKPLOY_PROFILES_JSON": "{\"redivo\":{\"url\":\"https://redivo.example.com\",\"apiKey\":\"dokp_redivo\"},\"personal\":{\"url\":\"https://personal.example.com\",\"apiKey\":\"dokp_personal\"},\"mezon\":{\"url\":\"https://mezon.example.com\",\"apiKey\":\"dokp_mezon\"}}"
      }
    }
  }
}

使用 list_profiles 查看可用的默认和命名配置档案目标，不会暴露 API 密钥。想要使用命名配置档案而不是默认目标时，请在 execute 中传入 profile：

{
  "profile": "redivo",
  "code": "return await dokploy.project.all()"
}

search 也接受可选的 profile 参数，用于验证配置档案名称，同时保持目录精简。

托管 HTTP 会话会将请求范围的远程凭据绑定到会话。命名的本地配置档案不会在此处公开。

想通过向导进行设置，而不是手动配置？

npx @vibetools/dokploy-mcp setup

选择客户端

• 文档首页
• 入门指南
• Cursor
• Codex
• Claude Code
• Claude Desktop

实际提供的功能

• search：发现 Dokploy 操作和契约
• execute：在一个沙盒调用中运行多步骤工作流
• list_profiles：列出已配置的 Dokploy 配置档案名称和 URL，不含机密信息
• 可选的 raw 模式：每项操作对应一个工具
• 可选的 hybrid 模式：Code Mode 加上选定的原始工具
• 可选的托管 HTTP 路径，支持 server.json 元数据和基于请求头的远程身份验证

如果你是新手，请使用默认模式，别再试图用聪明办法解决一个已有可行方案的问题。

接下来请阅读

• docs/getting-started.md
• docs/guides/profiles.md
• docs/guides/modes.md
• docs/guides/compose.md
• docs/guides/hosted-http.md
• docs/guides/hosted-deploy.md
• docs/guides/troubleshooting.md
• docs/live-e2e-proof.md

命令行界面

npx @vibetools/dokploy-mcp
npx @vibetools/dokploy-mcp serve-stdio
npx @vibetools/dokploy-mcp serve-http
npx @vibetools/dokploy-mcp setup
npx @vibetools/dokploy-mcp version

开发

git clone https://github.com/vcode-sh/dokploy-mcp.git && cd dokploy-mcp
npm install
npm run build
npm run lint
npm test
npm run docs:check:facts

其余内容都放在 docs 中，物归其位。

致谢

从 Dokploy/mcp 派生。起初有 67 个工具，经过大规模重构扩展到 377 个，随后又将整个项目重建为一种不再受工具数量影响的架构。

Mauricio Siu 构建了 Dokploy 本身——这个 MCP 服务所连接的 PaaS。没有这个平台，这套东西就只是向虚空发送 POST 请求的一种极其复杂的方式。

Henrique Andrade 编写了最初的 MCP 服务。15 次提交，所有 PR 都已合并。这类贡献者解决问题，而不是提出问题。

塑造了原始项目的贡献者：Joshua Macauley —— lucasleal-developer —— Nour Eddine Hamaidi —— Corey —— Azil0ne

未合并的 PR 依然是蓝图。这就是开源的运作方式——借鉴灵感，再配上更好的提交信息。

许可证

MIT - Vibe Code

原始作品由 Henrique Andrade 根据 Apache 2.0 许可证发布——请参阅 LICENSE-ORIGINAL。