使用说明
@vibetools/dokploy mcp
MCP服务器 多克普莱 与Codex、Cursor、Claude Code配合使用, 和克劳德桌面。
前面有三个工具。下面有数百个Dokploy程序。更少的模式税,更实际 部署。
大多数MCP服务器将您的上下文窗口视为免费垃圾填埋场。这个开始于
search, execute,以及 list_profiles,然后赚取剩下的。
这给你买了什么:
- 压缩默认曲面,而不是数百个原始端点工具
- 下方覆盖广泛的Dokloy涂层
- 部署、组合、日志、域、数据库和配置文件的真实工作流
- 本地
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%
| 每个工具基线的经典端点 | 当前代码模式默认值 | |
|---|---|---|
| 工具定义已发送 | 关于 92,354 代币 |
关于 1,681 代币 |
| 公共MCP工具 | 数百个端点模式 | 3 |
| 上下文窗口税 | 宽模式转储 | 紧凑固定表面 |
快速开始
从获取API密钥 Dokploy设置>配置文件>API/CLI.
对于基于env的设置,请从 .env.example.
如果您的客户端使用JSON样式的MCP配置,则整个块如下:
{
"mcpServers": {
"dokploy": {
"command": "npx",
"args": ["@vibetools/dokploy-mcp"],
"env": {
"DOKPLOY_URL": "https://panel.example.com",
"DOKPLOY_API_KEY": "dokp_..."
}
}
}
}
如果您的客户端使用基于CLI的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命令行界面 或本地
dokploy-mcp 配置?
您可能根本不需要env块。
使用多个Dokloy组织?
保留一个紧凑的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的情况下查看可用的默认和命名配置文件目标
钥匙。通过 profile 到 execute 当您希望使用命名配置文件而不是默认目标时:
{
"profile": "redivo",
"code": "return await dokploy.project.all()"
}
search 还接受可选 profile 保留配置文件名称验证的参数
相同的紧凑目录行为。
托管HTTP会话将其请求范围的远程凭据绑定到会话。命名为本地 配置文件不会在那里公开。
想要向导路径而不是手动配置吗?
npx @vibetools/dokploy-mcp setup
选择你的客户
你实际上得到了什么
search:了解Dokloy程序和合同execute:在一个沙盒调用中运行多步骤工作流list_profiles:列出配置的Dokploy配置文件名称和URL,不含机密- optional
raw模式:每个程序一个工具 - optional
hybrid模式:代码模式加上选定的原始工具 - 可选的托管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
- 文档/指南/故障排除.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
其余的住在 文档,它属于哪里。
鸣谢
源自 Dokploy/mcp从67个工具开始,大规模重构到377个,然后将整个东西重建成一个架构,使工具变得无关紧要。
萧如彬 建造 多克普莱 它本身——服务器与之通信的PaaS。如果没有平台,这是一种非常复杂的POST方式。
恩里克·安德拉德 编写了原始的MCP服务器。15次提交,每个PR合并。那种关闭问题而不是打开问题的贡献者。
塑造原作的贡献者: 约书亚麦考利 -- lucasleal显影剂 -- 努尔·埃丁·哈马伊迪 -- 科里 -- Azil0ne
未合并的PR仍然是蓝图。这就是开源的工作原理——通过更好的提交消息窃取灵感。
许可证
麻省理工学院- Vibe代码
