Dockhold MCP Server已验证已精选

什么是 Dockhold MCP Server？

Dockhold MCP Server 是应用托管平台 Dockhold 的官方 MCP 服务器。它让 Claude Code、Cursor、VS Code 等 AI 编程工具把当前文件夹或 GitHub 仓库部署到可访问的 HTTPS 地址，并读取状态和日志、设置变量、调整应用和托管数据库的规格。

只需安装一次、在浏览器中登录一次，然后对工具说 “put this online” 即可。所有本地安装方式都运行同一条命令 npx -y dockhold mcp，它使用 Dockhold CLI 保存在你电脑上的登录信息，把每个请求转发给 Dockhold。编辑器配置中不会写入任何敏感信息。对于无法启动本地命令的客户端，同样的工具也以远程方式在 https://api.dockhold.eu/mcp 提供，使用控制台 API 令牌认证。该服务器在官方 MCP 注册表中的名称为 eu.dockhold/dockhold。

如何使用 Dockhold MCP Server？

你需要 Node.js 18 或更高版本（用于 npx）以及一个 Dockhold 账号。在 app.dockhold.eu 注册，免费套餐无需绑定银行卡。

Claude Code

在 Claude Code 中运行这两条命令：

/plugin marketplace add dockhold/mcp
/plugin install dockhold@dockhold

这会安装 MCP 服务器以及一个 deploy 技能（/dockhold:deploy），它熟悉完整流程：预检、登录、部署，以及构建失败时该怎么办。

Cursor

使用 README 中的 “Add to Cursor” 按钮，或将以下内容添加到 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）：

{
  "mcpServers": {
    "dockhold": {
      "command": "npx",
      "args": ["-y", "dockhold", "mcp"],
      "env": { "DOCKHOLD_REF": "cursor" }
    }
  }
}

VS Code

code --add-mcp '{"name":"dockhold","command":"npx","args":["-y","dockhold","mcp"],"env":{"DOCKHOLD_REF":"vscode"}}'

Codex 和 Gemini CLI

codex mcp add dockhold --env DOCKHOLD_REF=codex -- npx -y dockhold mcp
gemini mcp add -e DOCKHOLD_REF=gemini dockhold npx -y dockhold mcp

Claude Desktop、Windsurf 及其他客户端

任何能启动命令的客户端都可以在其 MCP 设置中使用同样的配置块（Windsurf 读取 ~/.codeium/windsurf/mcp_config.json）：

{
  "mcpServers": {
    "dockhold": {
      "command": "npx",
      "args": ["-y", "dockhold", "mcp"]
    }
  }
}

DOCKHOLD_REF 是可选的，只用于告诉 Dockhold 你来自哪个工具。

登录

工具第一次需要访问你的账号时，会提示你在终端中运行：

npx dockhold login

浏览器会打开一个标签页，确认授权即可。登录有效期为 90 天，保存在你的电脑上而不是任何编辑器配置中，并由 CLI 和所有客户端共享。

远程服务器

对于只能通过 HTTP 连接的客户端，在 Dockhold 控制台的 Settings → API tokens 中创建令牌（只读、读取+部署，或包含 secrets），并以 bearer 方式传入：

claude mcp add --transport http dockhold https://api.dockhold.eu/mcp --header "Authorization: Bearer YOUR_DOCKHOLD_API_TOKEN"

这是唯一会把令牌写入配置文件的方式，请不要把该文件提交到版本控制中。

Dockhold MCP Server 的主要功能

• 所有客户端使用同一条本地命令，无需在编辑器配置中粘贴令牌。
• 浏览器登录与 Dockhold CLI 共享，有效期 90 天。
• 本地文件夹通过 CLI 部署，无需 GitHub 账号；GitHub 仓库通过 deploy_app 工具部署。
• 在对话中查看日志和状态，修改变量、内存、数据库和存储。
• 提供 Claude Code 插件，内含覆盖完整部署流程的 deploy 技能。
• 可选的远程端点，使用带权限范围的控制台令牌，包括 secrets 范围。
• 工具只能做你在控制台里能做的事，仅限你自己的应用和套餐范围内。

Dockhold MCP Server 工具

• 读取：list_apps、get_app_status（部署状态、URL、最近一次提交、错误信息）、get_app_logs、get_resource_usage（计算、数据库内存和存储资源池）以及 list_github_repos，后者提供部署私有仓库所需的 github_installation_id。
• 部署：deploy_app 将 GitHub 仓库部署为在线 Web 应用，deploy_group 一次部署多个相互连接的服务，redeploy_app 执行零停机重启。
• 配置：set_app_variable 和 unset_app_variable 修改非机密环境变量并使其生效。
• 规格与存储：resize_app、resize_database、resize_database_storage、set_app_storage 和 remove_app_storage。remove_app_storage 在删除文件前会请你确认。
• 机密（仅远程）：带有 secrets 范围的控制台令牌会解锁 set_app_secret、unset_app_secret、bind_app_secret、list_secrets 和 list_app_secrets。浏览器登录永远不具备该范围。

Dockhold MCP Server 的使用场景

• 首次部署：“Put this online。”工具会检查项目，必要时让你登录，完成部署并报告在线地址。
• 调试：“显示 recipe-box 的日志，告诉我上次部署为什么失败。”
• 私有仓库：“从 GitHub 部署我的私有仓库 api-server。”
• 扩容：“这个应用总是内存不足，给它加点内存。”
• 多服务应用：“把前端和 API 一起部署并连接起来。”

Dockhold MCP Server 常见问题排查

• 服务器启动时客户端放弃等待：首次 npx -y dockhold 下载可能太慢。先用 npm i -g dockhold 安装 CLI，然后把命令设为 dockhold，参数设为 ["mcp"]。
• 工具提示你尚未登录：运行 npx dockhold login。工具会在下一次调用时自动获取登录状态，无需重启。
• 应用部署成功但没有响应：你的应用必须监听 0.0.0.0:$PORT。
• 推送提交后没有重新部署：仅凭 URL 部署的仓库只会构建一次。将仓库连接到 Dockhold 才能在每次推送时部署。
• set_app_variable 拒绝某个值：它会拒绝任何看起来像密钥或密码的内容。请在控制台的 Secrets 部分添加机密。