---

| _ / _ | |/ / _ | | / _ / / | / |/ | _
| | | | | | | /| |) | | | | | V / | |/| | | | |) |
| || | || | . | /| || || || | | | | | || __/
|/ ___/||__| |__/ || || ||_|_|

🚀 DOKPLOY MCP SERVER 🚀

通往Dokploy宇宙的终极AI驱动接口

下一代模型上下文协议（MCP）服务器，它填补了AI助手与强大的Dokploy基础设施管理平台之间的鸿沟。该中间件将自然语言转换为API调用，使您能够通过对话无缝控制整个云基础设施。

✨ 功能矩阵 ✨

领域	功能
🐳 DOCKER	容器管理、配置、生命周期控制
🔄 项目	多项目工作流、组织、基于角色的访问
🚢 应用程序	部署、扩展、监控、日志
💾 数据库	MySQL, PostgreSQL, MongoDB, Redis, MariaDB
🔐 安全	SSH密钥、证书、注册表凭证
🌐 网络	域名管理、端点测试、诊断
🤖 AI	模型部署、推理、提示管理
📊 监控	状态检查、日志、指标、诊断
🔧 管理	用户管理、服务器设置、监控

🔮 基础设施管理的未来

+-------------------+ +--------------------+ +------------------+
| | | | | |
| AI ASSISTANTS |------->| DOKPLOY MCP |------->| CLOUD INFRA |
| (GPT, Claude, etc)|<-------| (You are here) |<-------| (The world) |
| | | | | |
+-------------------+ +--------------------+ +------------------+

通过自然语言无缝控制您的整个基础设施。Dokploy MCP服务器充当AI与您的云系统之间的通用翻译器。

🧠 智能特性

• API网关: 200多个API端点统一在一个智能接口下
• 上下文感知处理: 理解复杂的多步骤基础设施操作
• 错误恢复: 具有自动恢复建议的复杂错误处理
• 以安全为先的设计: 零信任架构，具有全面的访问控制
• 实时更新: 来自长时间运行操作的流式更新

🔥 快速开始

bash

克隆维度门户

git clone https://github.com/your-username/dokploy-mcp.git

进入漩涡

cd dokploy-mcp

安装量子依赖项

npm install

编译代码库

npm run build

在端口3000上启动服务器

npm start

在.env中配置您的维度网关:

DOKPLOY_API_URL=https://your-dokploy-instance.com/api
DOKPLOY_API_KEY=your-galactic-access-key
PORT=3000

🌌 通用API

主要接口

http
POST / HTTP/1.1
Content-Type: application/json

{
"name": "dokploy_operation_name",
"params": {
"key1": "value1",
"key2": "value2"
}
}

命令目录

http
GET /tools HTTP/1.1

系统状态

http
GET /health HTTP/1.1

🛸 操作能力

🐳 Docker控制模块

• 容器生命周期管理: 启动、停止、重启、检查
• 配置分析: 深度检查容器配置
• 智能匹配: 根据应用名称或标签模式查找容器
• 堆栈管理: 处理复杂的多容器应用程序

🏗️ 项目编排

• 多项目管理: 创建、更新、复制、删除项目
• 环境配置: 安全地管理环境变量
• 基于角色的访问: 细粒度权限控制- 资源分配：高效的资源分配

🚀 应用部署系统

• 持续部署：自动化应用部署
• 扩展操作：向上或向下扩展应用
• 环境管理：控制应用环境
• 状态监控：实时应用健康检查

🗄️ 数据库命令中心

• 多引擎支持：MySQL, PostgreSQL, MongoDB, Redis, MariaDB
• 实例管理：创建、配置、备份、恢复
• 性能调优：优化数据库性能
• 安全控制：用户管理、密码策略

🔐 安全操作

• 证书管理：创建、部署和轮换TLS证书
• SSH密钥控制：生成和管理SSH密钥
• 注册表凭据：安全的Docker注册表集成
• 用户访问控制：全面的用户权限系统

🌐 网络智能

• 域名管理：注册、配置、验证域名
• 流量分析：端点测试和诊断
• 负载均衡：高效分配流量
• SSL/TLS自动化：自动证书配置

🤖 AI运维

• 模型部署：在您的基础设施中部署AI模型
• 推理端点：创建和管理预测API
• 模型管理：AI模型版本控制
• 资源优化：高效分配GPU/TPU资源

🔍 诊断与监控

• 日志分析：实时日志流和分析
• 错误诊断：自动检测和诊断问题
• 性能指标：全面的系统性能监控
• 健康检查：持续的应用和服务健康监控

🔧 系统管理

• 用户管理：创建、更新、删除用户及其权限
• 服务器设置：自动化的服务器配置和配置
• 备份系统：计划备份和恢复操作
• 警报配置：为系统事件设置通知

💫 高级集成

Windsurf AI集成

json
{
"mcpServers": {
"dokploy-command-center": {
"command": "node",
"args": [
"/path/to/dokploy-mcp/dist/index.js"
],
"env": {
"DOKPLOY_API_URL": "https://your-dokploy-instance.com/api",
"DOKPLOY_API_KEY": "your-galactic-access-key",
"PORT": "3000"
},
"disabled": false,
"alwaysAllow": []
}
}
}

CLI访问门户

直接从终端与MCP服务器通信：

bash
curl -X POST http://localhost:3000
-H "Content-Type: application/json"
-d {"name":"dokploy_list_projects","params":{}}

🧪 开发者量子领域

npm run dev -- quantum-testing.ts # 测试现实结构

目录结构

/src
├── index.ts # 奇点
├── dokploy-client.ts # 通用翻译器
└── quantum-connector.ts # 时空结构连接器

🌠 加入未来

Dokploy MCP服务器代表了基础设施管理的下一个进化阶段——在这里，AI与云操作相结合，创造出比其各部分总和更伟大的东西。

/\__/    DOKPLOY MCP: 在这里，基础设施

/` 变成对话，而云管理变得毫不费力。
=== 0 0 ===
-- /
/
/
| |
|| || /
_oo__oo_/

📜 许可证

ISC - 在您的维度内免费使用

🧠 综合工具架构

Dokploy MCP使用强大的综合工具架构，通过较少的高级工具提供全面的功能。这使得AI助手更容易理解和利用全部功能，同时减少认知负担。

综合工具与其将200多个单独的API端点作为独立工具暴露出来，MCP将功能整合到了这些强大的主要工具中：

工具	描述	功能
dokploy_project	项目管理	列表、获取、创建、更新、删除
dokploy_application	应用操作	列表、获取、创建、更新、删除、部署、重启、停止、启动
dokploy_server	服务器管理	列表、获取、创建、更新、删除、设置、验证、安全
dokploy_docker	Docker容器操作	列表、重启、获取配置、按应用查找、按标签查找、查找堆栈
dokploy_domain	域名与证书管理	列表、获取、创建、更新、删除、验证、生成
dokploy_monitoring	监控与日志	应用状态、应用日志、服务器指标、设置
dokploy_diagnostics	诊断工具	测试端点、诊断502错误、检查安全
dokploy_deployment	部署操作	部署、重新部署、回滚
dokploy_database	统一数据库接口	创建、获取、启动、停止、部署、更新、删除、移动、重载、重建
dokploy_backup	备份管理	创建、获取、列表、更新、删除、手动
dokploy_system	MCP系统管理	状态、清除缓存、重置断路器、指标

工作原理

每个整合后的工具都遵循一致的动作模式：

json
{
"name": "dokploy_application",
"params": {
"action": "restart",
"applicationId": "app-123456"
}
}

服务器智能地将这些高层次动作映射到适当的低层次API调用，并处理参数验证，提供有用的错误信息。

优点

• 简化的心智模型：LLMs可以更容易理解和记住一小部分强大的工具。
• 一致的接口：所有工具都遵循相同基于动作的模式。
• 减少令牌使用：较少的工具描述意味着更多的令牌可用于推理。
• 更好的上下文管理：更容易跟踪同一工具内的相关操作。
• 增强的中间件能力：中间件层可以提供高级特性，如缓存、重试和断路。