____   ___  _  ______  _     _____   __  __  ____ ____  
|  _ \ / _ \| |/ /  _ \| |   / _ \ \ / / |  \/  |/ ___|  _ \ 
| | | | | | | ' /| |_) | |  | | | \ V /  | |\/| | |   | |_) |
| |_| | |_| | . \|  __/| |__| |_| || |   | |  | | |___|  __/ 
|____/ \___/|_|\_\_|   |_____\___/ |_|   |_|  |_|\____|_|    
                                                          

🚀 DOKPLOY MCP SERVER 🚀

通往Dokploy宇宙的终极AI接口

下一代模型上下文协议（MCP）服务器，弥合了AI助手与强大的Dokploy基础设施管理平台之间的差距。此中间件将自然语言转换为API调用，通过对话实现对整个云基础设施的无缝控制。

✨ 功能矩阵 ✨

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

🔮 基础设施管理的未来

+-------------------+        +--------------------+        +------------------+
|                   |        |                    |        |                  |
|  AI 助手         |------->|  DOKPLOY MCP       |------->|  云基础设施     |
| (GPT, Claude等)  |<-------|  (您在这里)        |<-------|  (世界)         |
|                   |        |                    |        |                  |
+-------------------+        +--------------------+        +------------------+

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

🧠 智能特性

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

🔥 快速开始

# 克隆维度门户
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

主要接口

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

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

命令目录

GET /tools HTTP/1.1

系统状态

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集成

{
  "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服务器通信：

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

工作原理

每个综合工具遵循一致的动作模式：

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

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

优点

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