@vibetools/dokploy-mcp 1.0.0 → 1.2.0

package/README.md

@@ -4,9 +4,9 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 [![Node >= 22](https://img.shields.io/badge/node-%3E%3D22-brightgreen)](https://nodejs.org/)
 
-MCP server for the Dokploy API. 196 tools across 23 modules. Your AI agent can now deploy apps, manage databases, configure domains, and handle backups -- without you touching a dashboard.
+MCP server for the Dokploy API. 377 tools across 35 modules. Your AI agent can now deploy apps, manage databases, configure domains, and handle backups -- without you touching a dashboard.
 
-Forked from [Dokploy/mcp](https://github.com/Dokploy/mcp) and rebuilt with expanded API coverage, tool annotations, Zod v4 schemas, lazy config loading, and a setup wizard. The original had 67 tools. This one has 196. Standing on shoulders, etc.
+Forked from [Dokploy/mcp](https://github.com/Dokploy/mcp) and rebuilt with expanded API coverage, tool annotations, Zod v4 schemas, lazy config loading, and a setup wizard. The original had 67 tools. This one has 377. Standing on shoulders, etc.
 
 ## Quick Start
 
@@ -45,7 +45,7 @@ If you already have the [Dokploy CLI](https://github.com/Dokploy/cli) installed
 
 ## Features
 
-- **196 tools, 23 modules** -- applications, compose, databases (Postgres/MySQL/MariaDB/MongoDB/Redis), domains, backups, Docker, settings, and more
+- **377 tools, 35 modules** -- applications, compose, environments, servers, Git providers, notifications, databases (Postgres/MySQL/MariaDB/MongoDB/Redis), domains, backups, deployment queues, rollback, patching, Docker, settings, preview deployments, schedules, 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
@@ -136,18 +136,24 @@ Already ran `setup` or have Dokploy CLI authenticated? Drop the `env` block enti
 
 | Module | Tools | Module | Tools |
 |--------|-------|--------|-------|
-| Project | 6 | Deployment | 2 |
-| Application | 26 | Docker | 4 |
-| Compose | 14 | Certificates | 4 |
-| Domain | 8 | Registry | 6 |
-| PostgreSQL | 13 | Destination | 6 |
-| MySQL | 13 | Backup | 8 |
-| MariaDB | 13 | Mounts | 4 |
-| MongoDB | 13 | Port | 4 |
-| Redis | 13 | Redirects | 4 |
+| Project | 8 | Deployment | 8 |
+| Environment | 7 | Docker | 7 |
+| Application | 29 | Server | 16 |
+| Compose | 28 | Certificates | 4 |
+| Domain | 9 | Registry | 6 |
+| Patch | 12 | SSH Key | 6 |
+| Git Provider | 2 | GitHub | 6 |
+| GitLab | 7 | PostgreSQL | 14 |
+| Notification | 38 | MySQL | 14 |
+| Destination | 6 | MariaDB | 14 |
+| Backup | 11 | MongoDB | 14 |
+| Mounts | 6 | Redis | 14 |
+| Port | 4 | Volume Backups | 6 |
+| Redirects | 4 | Rollback | 2 |
+| Preview Deployment | 4 | Schedule | 6 |
 | Security | 4 | Cluster | 4 |
-| Settings | 25 | Admin | 1 |
-| User | 1 | | |
+| Settings | 49 | Admin | 1 |
+| User | 7 | | |
 
 Full reference with parameters and descriptions: **[docs/tools.md](docs/tools.md)**
 

package/dist/api/client.d.ts

@@ -1,3 +1,4 @@
+export declare function unwrapTrpcResponse(data: unknown): unknown;
 export declare class ApiError extends Error {
     readonly status: number;
     readonly statusText: string;
@@ -5,6 +6,7 @@ export declare class ApiError extends Error {
     readonly endpoint: string;
     constructor(status: number, statusText: string, body: unknown, endpoint: string);
 }
+export declare function buildQueryString(body: unknown): string;
 export declare const api: {
     get: <T = unknown>(path: string, params?: Record<string, unknown>) => Promise<T>;
     post: <T = unknown>(path: string, body?: unknown) => Promise<T>;

package/dist/api/client.js

@@ -1,5 +1,38 @@
 import { resolveConfig } from '../config/resolver.js';
 const DEFAULT_TIMEOUT = 30_000;
+function getErrorMessage(body, statusText) {
+    if (typeof body !== 'object' || body === null) {
+        return statusText;
+    }
+    if ('message' in body && typeof body.message === 'string') {
+        return body.message;
+    }
+    if ('error' in body && typeof body.error === 'object' && body.error !== null) {
+        const error = body.error;
+        if ('message' in error && typeof error.message === 'string') {
+            return error.message;
+        }
+        if ('json' in error && typeof error.json === 'object' && error.json !== null) {
+            const json = error.json;
+            if ('message' in json && typeof json.message === 'string') {
+                return json.message;
+            }
+        }
+    }
+    return statusText;
+}
+export function unwrapTrpcResponse(data) {
+    if (typeof data !== 'object' || data === null)
+        return data;
+    const outer = data;
+    if (typeof outer.result !== 'object' || outer.result === null)
+        return data;
+    const result = outer.result;
+    if (typeof result.data !== 'object' || result.data === null)
+        return data;
+    const inner = result.data;
+    return 'json' in inner ? inner.json : data;
+}
 function getConfig() {
     const resolved = resolveConfig();
     if (!resolved) {
@@ -29,9 +62,7 @@ export class ApiError extends Error {
     body;
     endpoint;
     constructor(status, statusText, body, endpoint) {
-        const msg = typeof body === 'object' && body !== null && 'message' in body
-            ? body.message
-            : statusText;
+        const msg = getErrorMessage(body, statusText);
         super(`Dokploy API error (${status}): ${msg}`);
         this.status = status;
         this.statusText = statusText;
@@ -40,13 +71,15 @@ export class ApiError extends Error {
         this.name = 'ApiError';
     }
 }
-function buildQueryString(body) {
-    if (!body || typeof body !== 'object')
+export function buildQueryString(body) {
+    if (body == null)
+        return '';
+    if (typeof body !== 'object')
         return '';
-    const entries = Object.entries(body)
-        .filter(([, v]) => v != null)
-        .map(([k, v]) => [k, String(v)]);
-    return entries.length > 0 ? new URLSearchParams(entries).toString() : '';
+    const params = Object.fromEntries(Object.entries(body).filter(([, value]) => value != null));
+    return new URLSearchParams({
+        input: JSON.stringify({ json: params }),
+    }).toString();
 }
 /**
  * Checks whether an error was caused by an aborted fetch.
@@ -70,7 +103,7 @@ async function request(method, path, body) {
                 Accept: 'application/json',
                 'x-api-key': apiKey,
             },
-            body: method === 'POST' && body ? JSON.stringify(body) : undefined,
+            body: method === 'POST' && body ? JSON.stringify({ json: body }) : undefined,
             signal: controller.signal,
         });
         const text = await response.text();
@@ -84,7 +117,7 @@ async function request(method, path, body) {
         if (!response.ok) {
             throw new ApiError(response.status, response.statusText, data, path);
         }
-        return data;
+        return unwrapTrpcResponse(data);
     }
     catch (error) {
         if (error instanceof ApiError) {

package/dist/tools/_database.js

@@ -6,7 +6,7 @@ export function createDatabaseTools(config) {
         .object({ [idField]: z.string().min(1).describe(`Unique ${displayName} database ID`) })
         .strict();
     function tool(action, title, description, schema, opts = {}) {
-        const endpoint = `${type}.${action}`;
+        const endpoint = `/${type}.${action}`;
         const name = `dokploy_${type}_${action.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`)}`;
         if (opts.get) {
             return getTool({ name, title, description, schema, endpoint, annotations: opts.annotations });
@@ -14,12 +14,18 @@ export function createDatabaseTools(config) {
         return postTool({ name, title, description, schema, endpoint, annotations: opts.annotations });
     }
     const one = tool('one', `Get ${displayName} Details`, `Retrieve detailed information about a specific ${displayName} database managed by Dokploy. Returns the full configuration including connection settings, resource limits, environment variables, and current status. Requires the unique ${displayName} database ID.`, idSchema, { get: true });
-    const create = tool('create', `Create ${displayName} Database`, `Create a new ${displayName} database instance inside a Dokploy project. Requires a display name, app-level identifier, and the target project ID. Optionally specify a Docker image, description, or remote server. Returns the newly created database record.`, z
+    const create = tool('create', `Create ${displayName} Database`, `Create a new ${displayName} database instance inside a Dokploy environment. Requires a display name and the target environment ID. Optionally specify an app-level identifier, Docker image, description, or remote server. Returns the newly created database record.`, z
         .object({
         name: z.string().min(1).describe('Display name for the database'),
-        appName: z.string().min(1).describe('Unique app-level identifier'),
+        appName: z
+            .string()
+            .min(1)
+            .max(63)
+            .regex(/^[a-zA-Z0-9._-]+$/)
+            .optional()
+            .describe('Unique app-level identifier'),
         ...createFields.shape,
-        projectId: z.string().min(1).describe('Project ID to create the database in'),
+        environmentId: z.string().min(1).describe('Environment ID to create the database in'),
         dockerImage: z.string().optional().describe(`Docker image (default: ${defaultImage})`),
         description: z.string().nullable().optional().describe('Optional description'),
         serverId: z.string().nullable().optional().describe('Target server ID (null for local)'),
@@ -42,10 +48,10 @@ export function createDatabaseTools(config) {
     })
         .strict());
     const remove = tool('remove', `Remove ${displayName} Database`, `Permanently delete a ${displayName} database from Dokploy. This action removes the database container, its data, and all associated configuration. Requires the ${displayName} database ID. This operation is destructive and cannot be undone.`, idSchema, { annotations: { destructiveHint: true } });
-    const move = tool('move', `Move ${displayName} Database`, `Move a ${displayName} database from its current project to a different project within Dokploy. Requires the ${displayName} database ID and the destination project ID. The database configuration and data are preserved during the move.`, z
+    const move = tool('move', `Move ${displayName} Database`, `Move a ${displayName} database from its current environment to a different environment within Dokploy. Requires the ${displayName} database ID and the destination environment ID. The database configuration and data are preserved during the move.`, z
         .object({
         [idField]: z.string().min(1).describe(`Unique ${displayName} database ID`),
-        targetProjectId: z.string().min(1).describe('Destination project ID'),
+        targetEnvironmentId: z.string().min(1).describe('Destination environment ID'),
     })
         .strict());
     const deploy = tool('deploy', `Deploy ${displayName} Database`, `Deploy a ${displayName} database container in Dokploy. Triggers the build and start process for the specified database. Requires the ${displayName} database ID. Returns the deployment status.`, idSchema);
@@ -78,6 +84,18 @@ export function createDatabaseTools(config) {
         env: z.string().nullable().optional().describe('Environment variables as a string'),
     })
         .strict());
+    const search = tool('search', `Search ${displayName} Databases`, `Search ${displayName} databases in Dokploy by free text or field-specific filters. Supports pagination through limit and offset.`, z
+        .object({
+        q: z.string().optional().describe('Free-text query'),
+        name: z.string().optional().describe('Display name'),
+        appName: z.string().optional().describe('App-level identifier'),
+        description: z.string().optional().describe('Description'),
+        projectId: z.string().optional().describe('Project ID'),
+        environmentId: z.string().optional().describe('Environment ID'),
+        limit: z.number().min(1).max(100).optional().describe('Maximum number of results'),
+        offset: z.number().min(0).optional().describe('Number of results to skip'),
+    })
+        .strict(), { get: true });
     return [
         one,
         create,
@@ -92,5 +110,6 @@ export function createDatabaseTools(config) {
         changeStatus,
         saveExternalPort,
         saveEnvironment,
+        search,
     ];
 }

package/dist/tools/_factory.d.ts

@@ -12,6 +12,8 @@ export interface ToolDefinition {
     name: string;
     title: string;
     description: string;
+    endpoint?: string;
+    method?: 'GET' | 'POST';
     schema: AnyZodObject;
     annotations: ToolAnnotations;
     handler: (input: Record<string, unknown>) => Promise<{

package/dist/tools/_factory.js

@@ -1,8 +1,15 @@
 import { ApiError, api } from '../api/client.js';
+function wrapStructured(data) {
+    if (Array.isArray(data))
+        return { items: data };
+    if (data === null || data === undefined || typeof data !== 'object')
+        return { value: data };
+    return data;
+}
 function success(data) {
     return {
         content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
-        structuredContent: data,
+        structuredContent: wrapStructured(data),
     };
 }
 function error(message, details) {
@@ -55,7 +62,7 @@ export function createTool(def) {
     };
 }
 export function postTool(opts) {
-    return createTool({
+    const tool = createTool({
         name: opts.name,
         title: opts.title,
         description: opts.description,
@@ -63,9 +70,14 @@ export function postTool(opts) {
         annotations: opts.annotations,
         handler: async ({ input, api }) => api.post(opts.endpoint, input),
     });
+    return {
+        ...tool,
+        endpoint: opts.endpoint,
+        method: 'POST',
+    };
 }
 export function getTool(opts) {
-    return createTool({
+    const tool = createTool({
         name: opts.name,
         title: opts.title,
         description: opts.description,
@@ -82,7 +94,12 @@ export function getTool(opts) {
                     params[k] = v;
                 }
             }
-            return api.get(opts.endpoint, Object.keys(params).length > 0 ? params : undefined);
+            return api.get(opts.endpoint, params);
         },
     });
+    return {
+        ...tool,
+        endpoint: opts.endpoint,
+        method: 'GET',
+    };
 }