Dokploy MCP 服务器

Dokploy 的一个全面的模型上下文协议（MCP）服务器，提供对整个Dokploy API的类型安全访问，并覆盖所有可用端点的广泛工具。

特性

• 380个工具 覆盖Dokploy API的所有功能
• 智能工具选择 核心工具默认启用
• 高级工具 默认禁用以提高性能
• 类型安全 集成自动生成的OpenAPI类型
• 基于环境 的身份验证
• 模块化架构 每个工具在单独的文件中
• 全面错误处理 对所有HTTP状态码
• 生产就绪 的MCP服务器，优化了工具选择

📋 参见 TOOLS_STATUS.md 获取完整的工具分解和当前状态

安装

npx -y dokploy-mcp

配置

设置以下环境变量：

export DOKPLOY_URL="https://your-dokploy-instance.com"
export DOKPLOY_API_KEY="your-api-key-here"

获取您的API密钥

您可以在Dokploy仪表板中创建API密钥：

1. 在您的Dokploy仪表板中前往 设置 → 个人资料
2. 导航到 /dashboard/settings/profile
3. 生成一个新的API密钥
4. 复制该密钥并将其作为 DOKPLOY_API_KEY 环境变量使用

使用Claude Desktop

添加到您的Claude Desktop配置：

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

可用工具

要查看所有可用工具的完整列表、描述及其当前状态，请参阅：

📋 TOOLS_STATUS.md - 包含状态和管理说明的完整工具参考

工具管理

运行时工具控制

您可以使用命令行参数或环境变量来控制哪些工具在运行时启用或禁用：

启用额外工具

# 启用特定工具或类别
npx -y dokploy-mcp --enable-tools postgres/,application-cancelDeployment

# 启用多个类别
npx -y dokploy-mcp --enable-tools postgres/,mysql/,notification/

禁用特定工具

# 禁用特定工具或类别
XMCP_DISABLE_TOOLS=admin/,application-cancelDeployment npx -y dokploy-mcp

# 禁用多个类别
XMCP_DISABLE_TOOLS=admin/,settings/,stripe/ npx -y dokploy-mcp

Claude Desktop配置

{
  "mcpServers": {
    "dokploy": {
      "command": "npx",
      "args": ["-y", "dokploy-mcp", "--enable-tools", "postgres/,mysql/"],
      "env": {
        "DOKPLOY_URL": "https://your-dokploy-instance.com",
        "DOKPLOY_API_KEY": "your-api-key-here",
        "XMCP_DISABLE_TOOLS": "admin/,stripe/"
      }
    }
  }
}

工具模式

• 类别模式：postgres/, mysql/, notification/ - 启用/禁用整个类别
• 特定工具：application-cancelDeployment, server-create - 启用/禁用单个工具
• 多个模式：用逗号分隔：postgres/,mysql/,application-cancelDeployment

工具类别

有关工具类别的详细信息及其当前状态，请参阅 TOOLS_STATUS.md。

开发模式

要永久启用额外工具，请修改每个工具元数据中的 disabled 属性：

export const metadata: ToolMetadata = {
  name: 'tool-name',
  description: 'Tool description',
  annotations: {
    title: 'Tool Title',
    destructiveHint: false,
    idempotentHint: true,
  },
  disabled: false, // 设置为false启用，true禁用
}

文档

• TOOLS_STATUS.md - 所有380个工具的完整列表及其状态
• API覆盖率 - 启用/禁用工具的详细分解

开发

# 安装依赖
pnpm install

# 构建项目（自动更新TOOLS_STATUS.md）
pnpm build

# 手动更新工具状态
pnpm run update-tools-status

# 开发模式运行
pnpm dev

许可证

MIT