Dokploy Mcp

Dokploy MCP 服务

功能全面的 Dokploy 模型上下文协议（MCP）服务，可安全地访问完整的 Dokploy API，并通过广泛的工具覆盖所有可用端点。

功能

• 380 个工具，覆盖 Dokploy API 的 100% 功能
• 智能工具选择，默认启用核心工具
• 高级工具可用，但默认禁用以提升性能
• 类型安全的集成，采用自动生成的 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 - 完整的工具参考，包含状态和管理说明

工具管理

运行时工具控制

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

启用其他工具

# Enable specific tools or categories
npx -y dokploy-mcp --enable-tools postgres/,application-cancelDeployment

# Enable multiple categories
npx -y dokploy-mcp --enable-tools postgres/,mysql/,notification/

禁用特定工具

# Disable specific tools or categories
XMCP_DISABLE_TOOLS=admin/,application-cancelDeployment npx -y dokploy-mcp

# Disable multiple categories
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, // Set to false to enable, true to disable
}

文档

• TOOLS_STATUS.md - 全部 380 个工具及其状态的完整列表
• API 覆盖范围 - 启用和禁用工具的详细分类

开发

# Install dependencies
pnpm install

# Build the project (automatically updates TOOLS_STATUS.md)
pnpm build

# Update tools status manually
pnpm run update-tools-status

# Run in development
pnpm dev

许可证

MIT