v1.0.0

v1.0.0

The one where it stops being a beta.

Forked from Dokploy/mcp, rebuilt from the ground up. 196 tools across 23 modules. Your AI agent can now deploy apps, manage databases, configure domains, and handle backups -- without you touching a dashboard.

What's in the box

• 196 tools, 23 modules -- applications, compose, databases (Postgres/MySQL/MariaDB/MongoDB/Redis), domains, backups, Docker, settings, and more
• Tool annotations -- readOnlyHint, destructiveHint, idempotentHint so clients can warn before you nuke something
• Type-safe schemas -- Zod v4 validation on every parameter
• Lazy config loading -- validates credentials on first API call, not at startup
• Three config sources -- env vars > config file > Dokploy CLI (first match wins)
• Setup wizard -- npx @vibetools/dokploy-mcp setup

v1.0.0 highlights

Architecture overhaul

• Database tool factory -- 5 nearly-identical database modules (postgres, mysql, mariadb, mongo, redis) consolidated into a single factory. ~900 lines of duplication eliminated. Adding a new database type is now 15 lines of config.
• Fixed annotations bug -- openWorldHint default was being double-applied in postTool and getTool, causing override issues. Defaults now flow through createTool once.
• Error mapping cleanup -- mapApiError switch replaced with a lookup table.

Config & API client

• Zod-ified config validation -- manual type guards in readConfigFile() and readDokployCliConfig() replaced with Zod schemas. 40 lines → 6 lines.
• API client cleanup -- simplified query string builder, standardized timeouts, documented the abort error dual-check.

Test suite (new)

• Vitest 4.0.18 -- 55 tests across 6 files
• Coverage reporting with @vitest/coverage-v8 -- shown in CI step summaries, not enforced (network-dependent code doesn't fake well)
• Tests cover: tool factory, database factory, config resolution, API errors, tool registration integrity (196 tools, unique names, correct annotations)

CI/CD

• GitHub Actions upgraded -- checkout v6, setup-node v6, upload-artifact v6, download-artifact v7
• Test job added to CI, PR validation, and release workflows
• Coverage reports in GitHub step summaries on every PR
• Dependabot configured for weekly npm + Actions updates
• PR template with test plan checklist

Housekeeping

• Apache 2.0 attribution -- LICENSE-ORIGINAL preserves the original copyright from Dokploy/mcp
• Fork attribution in README with contributor credits

Quick start

{
  "mcpServers": {
    "dokploy": {
      "command": "npx",
      "args": ["@vibetools/dokploy-mcp"],
      "env": {
        "DOKPLOY_URL": "https://panel.example.com",
        "DOKPLOY_API_KEY": "your-api-key"
      }
    }
  }
}

Works with Claude Desktop, Claude Code, Cursor, VS Code, and anything that speaks MCP.

---

Standing on the shoulders of Mauricio Siu (Dokploy creator) and Henrique Andrade (original MCP author). Full credits in README.

Full Changelog: v0.5.0...v1.0.0

v0.5.0

Full Changelog: v0.4.0...v0.5.0

v0.4.0

Full Changelog: https://github.com/vcode-sh/dokploy-mcp/commits/v0.4.0