Dokploy MCP 服务器

Dokploy MCP 软件 服务器曝光 所有 Dokploy API 端点 通过《环境协议范本》作为消耗性工具。 它允许MCP兼容客户端(例如AI模型,其他应用程序)在程序上与你的多克普勒服务器交互.

与 508个工具 纵横 49个职类,这个服务器提供了Dokploy API的完整覆盖——从项目和应用管理到数据库,通知,SSO,多克,备份等等.

开始

所需资源

• 节点.js QQv 18.0.0(或多克克)
• 光标、 VS 代码、 Claude 桌面或 MCP 客户端
• 运行中的 Dokploy 服务器实例

在光标中安装

转到 : Settings - > (中文) Cursor Settings - > (中文) MCP - > (中文) Add new global MCP server

将此添加到您的光标 ~/.cursor/mcp.json 文档。 您也可以通过创建 .cursor/mcp.json 在您的工程文件夹中。 见 光标 MCP 文件 需要更多信息.

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

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

{
  "mcpServers": {
    "dokploy-mcp": {
      "command": "deno",
      "args": ["run", "--allow-env", "--allow-net", "npm:@dokploy/mcp"],
      "env": {
        "DOKPLOY_URL": "https://your-dokploy-server.com",
        "DOKPLOY_API_KEY": "your-dokploy-api-token"
      }
    }
  }
}

在 Windsurf 安装

将此添加到您的 Windsurf MCP 配置文件 。 见 Windsurf MCP 文件 需要更多信息.

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

在 VS 代码中安装

将此添加到您的 VS 代码 MCP 配置文件中 。 见 VS 代码 MCP 文件 需要更多信息.

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

在 Claude 代码中安装

用 CLI 将 MCP 服务器添加到 Claude Code 中 :

claude mcp add dokploy-mcp -- npx -y @dokploy/mcp

然后将环境变量设置在您的 .claude/settings.json 或用内线通过 :

DOKPLOY_URL=https://your-dokploy-server.com DOKPLOY_API_KEY=your-token claude

在 Zed 安装

将此添加到您的 Zed settings.json。见 Zed 上下文服务器文件 需要更多信息.

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

在 Claude 桌面中安装

将此添加到您的 Claude 桌面 claude_desktop_config.json 文档。 见 Claude 桌面 MCP 文件 需要更多信息.

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

在 BoltAI 安装

打开应用的"设置"一页,导航到"Plugins",并输入以下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"
      }
    }
  }
}

在 Opencode 中安装

将此添加到您的 OpenCode 配置中( 默认位置为 ~/. config/ opencode/ opencode. json 或 opencode. json 为本地/ 项目配置) 。 见 打开代码 MCP 配置 需要更多信息.

{
  "mcp": {
    "dokploy": {
      "type": "local",
      "command": ["npx", "-y", "@dokploy/mcp"],
      "environment": {
        "DOKPLOY_URL": "https://your-dokploy-server.com",
        "DOKPLOY_API_KEY": "your-dokploy-api-token"
      },
      "enabled": true
    }
  }
}

使用嵌入器

Docker 容器支持两者 静态 财务报告和审定财务报表 HTTP 密码 运输模式,使其对不同的部署情景具有灵活性.

1. 构建多克图像 :

   git clone https://github.com/Dokploy/mcp.git
   cd mcp
   docker build -t dokploy-mcp .
   

2. 手动嵌入命令 :

   Stdio 模式( MCP 客户端):

   docker run -it --rm \
     -e DOKPLOY_URL=https://your-dokploy-server.com \
     -e DOKPLOY_API_KEY=your_token_here \
     dokploy-mcp
   

   HTTP 模式( 用于网络应用) :

   docker run -it --rm \
     -p 8080:3000 \
     -e MCP_TRANSPORT=http \
     -e DOKPLOY_URL=https://your-dokploy-server.com \
     -e DOKPLOY_API_KEY=your_token_here \
     dokploy-mcp
   

3. 多克编曲 :

   使用提供的 docker-compose.yml 用于生产部署:

   # Start HTTP service
   docker-compose up -d dokploy-mcp-http
   
   # View logs
   docker-compose logs -f dokploy-mcp-http
   

4. MCP 客户端配置 :

   对于stdio模式(Claude桌面、VS代码等):

   {
     "mcpServers": {
       "dokploy-mcp": {
         "command": "docker",
         "args": [
           "run",
           "-i",
           "--rm",
           "-e",
           "DOKPLOY_URL=https://your-dokploy-server.com",
           "-e",
           "DOKPLOY_API_KEY=your_token_here",
           "dokploy-mcp"
         ]
       }
     }
   }
   

   HTTP 模式( 网络应用) :

   先启动 HTTP 服务器,然后配置您的客户端以连接到 http://localhost:3000/mcp。 。 。 .

在 Windows 中安装

与Linux或macOS相比,Windows上的配置略有不同. 使用 cmd 作为命令包线 :

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

环境变量

对于Cloudflare Access 或类似倒置代理机背后的 Dokploy 实例,通过带有这样的占位符值的服务键头:

DOKPLOY_CUSTOM_HEADERS='{"CF-Access-Client-Id":"your-client-id.access","CF-Access-Client-Secret":"your-client-secret"}'

运输模式

这个 MCP 服务器支持多个传输模式来适应不同的使用大小写 :

Stdio 模式( 默认)

默认模式使用stdio进行直接进程通信,理想的桌面应用程序和命令行使用.

# Run with stdio (default)
npx -y @dokploy/mcp

HTTP 模式(可立体 HTTP + 遗留 SSE)

现代 HTTP 模式通过 HTTP/ HTTPS 支持显示服务器 现代和遗留协议 最大兼容性 :

• 可流式HTTP(MCP 2025-03-26) - 有会议管理的现代协议
• 遗产SSE(MCP 2024-11-05) - 对老客户的后向兼容性

# Run with HTTP mode
npx -y @dokploy/mcp --http
# or via environment variable
MCP_TRANSPORT=http npx -y @dokploy/mcp

现代可流 HTTP 端点 :

遗产 SSE 终点( Backwards 兼容性) :

可用工具( 508)

这个 MCP 服务器提供 508个工具 覆盖整个Dokploy API,组织成 49个职类数字 :

核心资源

数据库

基础设施

安全认证( A)

业务

其它

工具过滤

默认情况下,服务器会曝光所有多克普洛伊API工具. 一些MCP客户端和LLM提供商在向模型发送非常大的工具列表时可以比较慢或不太可靠. 可以用预设或标签过滤器来减少已装入的工具.

使用 DOKPLOY_TOOL_PRESET 用于共同工作流程:

# Recommended starting point for clients/providers sensitive to large toolsets
DOKPLOY_TOOL_PRESET=minimal

对于精确控制,设定 DOKPLOY_ENABLED_TAGS数字 :

# Only load project, application, and postgres tools
DOKPLOY_ENABLED_TAGS=project,application,postgres

也可以从预设中删除分类 :

DOKPLOY_TOOL_PRESET=core
DOKPLOY_DISABLED_TAGS=postgres,redis

若为 DOKPLOY_ENABLED_TAGS 设定,它优先于 DOKPLOY_TOOL_PRESET。 。 。 . DOKPLOY_DISABLED_TAGS 最后应用.

所有工具都包括语义说明(readOnlyHint, (中文(简体) ), destructiveHint, (中文(简体) ), idempotentHint)帮助MCP客户了解他们的行为和安全特征.

建筑

与 @ modelcontextprotocol/ sdk (英语), (中文(简体) ), 类型脚本,以及 佐德语Name 用于类型安全计划验证:

• 508 工具 覆盖整个 Dokploy API
• 多重运输: Stdio (默认)和 HTTP (Streamable HTTP + 遗留的SSE)
• 自动生成的工具: 工具由 Dokploy OpenAPI 光谱通过生成 pnpm generate:all
• 工具过滤: 仅装入所需类别 DOKPLOY_ENABLED_TAGS
• 强力错误处理: 集中了 API 客户端并带有截取器和重试逻辑
• 类型安全: 带有 Zod schema 验证的完整类型脚本
• 工具说明: MCP 客户端行为理解语义提示

发展

清除工程并安装依赖性 :

git clone https://github.com/Dokploy/mcp.git
cd mcp
pnpm install

构建 :

pnpm build

从 Dokploy OpenAPI 光谱重生工具 :

pnpm generate:all

本地配置示例

{
  "mcpServers": {
    "dokploy-mcp": {
      "command": "npx",
      "args": ["tsx", "/path/to/mcp/src/index.ts"],
      "env": {
        "DOKPLOY_URL": "https://your-dokploy-server.com",
        "DOKPLOY_API_KEY": "your-dokploy-api-token"
      }
    }
  }
}

与 MCP 检查员进行测试

npx -y @modelcontextprotocol/inspector npx @dokploy/mcp

解决问题

MCP 客户端错误

1. 尝试添加 @latest 转到软件包名称.

2. 请确定您正在使用Node v18 或更高端的本地获取支持 npx。 。 。 .

3. 检查您 DOKPLOY_URL 财务报告和审定财务报表 DOKPLOY_API_KEY 环境变量设置正确.

4. 如果处理工具时有太多工具在装入, 或是您的提供者出厂, 请从 DOKPLOY_TOOL_PRESET=minimal,然后使用 DOKPLOY_ENABLED_TAGS 用于在必要时进行精确分类过滤.

捐款

我们欢迎捐款! 请检查access-date=中的日期值 (帮助) 贡献指南。 。 。 .

支助

如果你遇到任何问题,有问题,或者想提出一个特征,请 打开一个问题 在我们的 GitHub 仓库中.

许可证

本项目根据以下规定获得许可证: Apache 许可证。 。 。 .