@vibetools/dokploy-mcp 1.2.0 → 2.0.1

package/dist/{tools/_factory.js → mcp/tool-factory.js}

@@ -1,9 +1,11 @@
 import { ApiError, api } from '../api/client.js';
 function wrapStructured(data) {
-    if (Array.isArray(data))
+    if (Array.isArray(data)) {
         return { items: data };
-    if (data === null || data === undefined || typeof data !== 'object')
+    }
+    if (data === null || data === undefined || typeof data !== 'object') {
         return { value: data };
+    }
     return data;
 }
 function success(data) {
@@ -89,9 +91,9 @@ export function getTool(opts) {
         },
         handler: async ({ input, api }) => {
             const params = {};
-            for (const [k, v] of Object.entries(input)) {
-                if (v !== undefined && v !== null) {
-                    params[k] = v;
+            for (const [key, value] of Object.entries(input)) {
+                if (value !== undefined && value !== null) {
+                    params[key] = value;
                 }
             }
             return api.get(opts.endpoint, params);

package/dist/server.d.ts

@@ -1,2 +1,2 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export declare function createServer(): McpServer;

package/dist/server.js

@@ -1,17 +1,4 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { allTools } from './tools/index.js';
+import { createCodeModeServer } from './codemode/server-codemode.js';
 export function createServer() {
-    const server = new McpServer({
-        name: 'dokploy-mcp-server',
-        version: '1.0.0',
-    });
-    for (const tool of allTools) {
-        server.registerTool(tool.name, {
-            title: tool.title,
-            description: tool.description,
-            inputSchema: tool.schema,
-            annotations: tool.annotations,
-        }, tool.handler);
-    }
-    return server;
+    return createCodeModeServer();
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vibetools/dokploy-mcp",
-  "version": "1.2.0",
-  "description": "MCP Server for the Dokploy API - complete coverage of all endpoints",
+  "version": "2.0.1",
+  "description": "Dokploy MCP server with Code Mode by default",
   "type": "module",
   "exports": {
     ".": {
@@ -16,8 +16,19 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "npm run clean:dist && npm run build:v2:artifacts && tsc",
+    "build:v2:artifacts": "node scripts/v2/resolve-openapi.mjs && node scripts/v2/build-openapi-index.mjs && node scripts/v2/build-runtime-schemas.mjs && node scripts/v2/build-sandbox-sdk.mjs",
+    "bench:protocol": "node scripts/v2/measure-tools-list.mjs",
+    "bench:search": "node scripts/v2/bench-search.mjs",
+    "bench:execute": "node scripts/v2/bench-execute.mjs",
+    "bench:sandbox-startup": "node scripts/v2/bench-sandbox-startup.mjs",
+    "ci:budgets": "node scripts/v2/check-budgets.mjs",
+    "ci:full": "npm test && npm run lint && npm run build && npm run ci:budgets && npm run smoke:mcp && npm run smoke:search && npm run smoke:execute",
+    "clean:dist": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
     "dev": "tsc --watch",
+    "smoke:mcp": "npx -y @modelcontextprotocol/inspector --cli node dist/index.js --method tools/list",
+    "smoke:search": "node scripts/v2/smoke-search-live.mjs",
+    "smoke:execute": "node scripts/v2/smoke-execute-live.mjs",
     "start": "node dist/index.js",
     "test": "vitest run",
     "test:watch": "vitest",
@@ -30,19 +41,19 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@clack/prompts": "^1.0.1",
-    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@clack/prompts": "^1.1.0",
+    "@modelcontextprotocol/sdk": "^1.28.0",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.4",
-    "@types/node": "^22.19.11",
-    "@vitest/coverage-v8": "^4.0.18",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
+    "@biomejs/biome": "^2.4.9",
+    "@types/node": "^24.0.10",
+    "@vitest/coverage-v8": "^4.1.1",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.1"
   },
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=24.0.0"
   },
   "sideEffects": false,
   "license": "MIT",

package/dist/tools/_database.d.ts

@@ -1,12 +0,0 @@
-import { z } from 'zod';
-import { type ToolDefinition } from './_factory.js';
-type AnyZodObject = z.ZodObject;
-export interface DatabaseConfig {
-    type: string;
-    idField: string;
-    displayName: string;
-    defaultImage: string;
-    createFields: AnyZodObject;
-}
-export declare function createDatabaseTools(config: DatabaseConfig): ToolDefinition[];
-export {};

package/dist/tools/_database.js

@@ -1,115 +0,0 @@
-import { z } from 'zod';
-import { getTool, postTool } from './_factory.js';
-export function createDatabaseTools(config) {
-    const { type, idField, displayName, defaultImage, createFields } = config;
-    const idSchema = z
-        .object({ [idField]: z.string().min(1).describe(`Unique ${displayName} database ID`) })
-        .strict();
-    function tool(action, title, description, schema, opts = {}) {
-        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 });
-        }
-        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 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)
-            .max(63)
-            .regex(/^[a-zA-Z0-9._-]+$/)
-            .optional()
-            .describe('Unique app-level identifier'),
-        ...createFields.shape,
-        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)'),
-    })
-        .strict());
-    const update = tool('update', `Update ${displayName} Database`, `Update the configuration of an existing ${displayName} database in Dokploy. Supports modifying the display name, Docker image, resource limits (CPU and memory), custom start command, environment variables, and external port. Requires the ${displayName} database ID. Only the provided fields are updated.`, z
-        .object({
-        [idField]: z.string().min(1).describe(`Unique ${displayName} database ID`),
-        name: z.string().min(1).optional().describe('Display name'),
-        appName: z.string().min(1).optional().describe('App-level identifier'),
-        description: z.string().nullable().optional().describe('Description'),
-        dockerImage: z.string().optional().describe('Docker image'),
-        memoryReservation: z.number().nullable().optional().describe('Memory reservation in MB'),
-        memoryLimit: z.number().nullable().optional().describe('Memory limit in MB'),
-        cpuReservation: z.number().nullable().optional().describe('CPU reservation'),
-        cpuLimit: z.number().nullable().optional().describe('CPU limit'),
-        command: z.string().nullable().optional().describe('Custom start command'),
-        env: z.string().nullable().optional().describe('Environment variables'),
-        externalPort: z.number().nullable().optional().describe('External port'),
-    })
-        .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 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`),
-        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);
-    const start = tool('start', `Start ${displayName} Database`, `Start a previously stopped ${displayName} database container in Dokploy. The database must already be deployed. Requires the ${displayName} database ID. Returns the updated status after starting.`, idSchema);
-    const stop = tool('stop', `Stop ${displayName} Database`, `Stop a running ${displayName} database container in Dokploy. The database data is preserved but the container will no longer accept connections. Requires the ${displayName} database ID. This is a destructive action as it interrupts active connections.`, idSchema, { annotations: { destructiveHint: true } });
-    const reload = tool('reload', `Reload ${displayName} Database`, `Reload the ${displayName} database container in Dokploy without a full restart. Applies configuration changes that do not require a rebuild. Requires the ${displayName} database ID and the app-level identifier. Returns the reload status.`, z
-        .object({
-        [idField]: z.string().min(1).describe(`Unique ${displayName} database ID`),
-        appName: z.string().min(1).describe('App-level identifier'),
-    })
-        .strict());
-    const rebuild = tool('rebuild', `Rebuild ${displayName} Database`, `Rebuild the ${displayName} database container from scratch in Dokploy. This tears down the existing container and recreates it with the current configuration. Requires the ${displayName} database ID. Useful after changing the Docker image or when the container is in a broken state.`, idSchema);
-    const changeStatus = tool('changeStatus', `Change ${displayName} Status`, `Manually set the application status of a ${displayName} database in Dokploy. Accepts one of: idle, running, done, or error. Requires the ${displayName} database ID and the new status value. Useful for correcting a stale or incorrect status.`, z
-        .object({
-        [idField]: z.string().min(1).describe(`Unique ${displayName} database ID`),
-        applicationStatus: z
-            .enum(['idle', 'running', 'done', 'error'])
-            .describe('New application status'),
-    })
-        .strict());
-    const saveExternalPort = tool('saveExternalPort', `Save ${displayName} External Port`, `Set or clear the external port mapping for a ${displayName} database in Dokploy. When set, the database is accessible from outside the Docker network on the specified port. Pass null to remove the external port. Requires the ${displayName} database ID.`, z
-        .object({
-        [idField]: z.string().min(1).describe(`Unique ${displayName} database ID`),
-        externalPort: z.number().nullable().describe('External port number (null to remove)'),
-    })
-        .strict());
-    const saveEnvironment = tool('saveEnvironment', `Save ${displayName} Environment`, `Overwrite the environment variables for a ${displayName} database in Dokploy. Replaces all existing environment variables with the provided value. Pass the variables as a single string (one per line, KEY=VALUE format). Requires the ${displayName} database ID.`, z
-        .object({
-        [idField]: z.string().min(1).describe(`Unique ${displayName} database ID`),
-        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,
-        update,
-        remove,
-        move,
-        deploy,
-        start,
-        stop,
-        reload,
-        rebuild,
-        changeStatus,
-        saveExternalPort,
-        saveEnvironment,
-        search,
-    ];
-}

package/dist/tools/admin.d.ts

@@ -1,2 +0,0 @@
-import { type ToolDefinition } from './_factory.js';
-export declare const adminTools: ToolDefinition[];

package/dist/tools/admin.js

@@ -1,61 +0,0 @@
-import { z } from 'zod';
-import { postTool } from './_factory.js';
-// ── tools ────────────────────────────────────────────────────────────
-const setupMonitoring = postTool({
-    name: 'dokploy_admin_setup_monitoring',
-    title: 'Setup Monitoring',
-    description: 'Configure server and container monitoring metrics. Sets up refresh rates, retention policies, callback URLs, resource thresholds, and container service filters for the monitoring system.',
-    schema: z
-        .object({
-        metricsConfig: z
-            .object({
-            server: z
-                .object({
-                refreshRate: z
-                    .number()
-                    .min(2)
-                    .describe('Metrics refresh rate in seconds (minimum 2)'),
-                port: z.number().min(1).describe('Monitoring port number'),
-                token: z.string().describe('Authentication token for metrics endpoint'),
-                urlCallback: z.string().url().describe('Callback URL for metrics data'),
-                retentionDays: z.number().min(1).describe('Number of days to retain metrics data'),
-                cronJob: z
-                    .string()
-                    .min(1)
-                    .describe('Cron expression for scheduled metrics collection'),
-                thresholds: z
-                    .object({
-                    cpu: z.number().min(0).describe('CPU usage threshold percentage'),
-                    memory: z.number().min(0).describe('Memory usage threshold percentage'),
-                })
-                    .strict(),
-            })
-                .strict(),
-            containers: z
-                .object({
-                refreshRate: z
-                    .number()
-                    .min(2)
-                    .describe('Container metrics refresh rate in seconds (minimum 2)'),
-                services: z
-                    .object({
-                    include: z
-                        .array(z.string())
-                        .optional()
-                        .describe('Service names to include in monitoring'),
-                    exclude: z
-                        .array(z.string())
-                        .optional()
-                        .describe('Service names to exclude from monitoring'),
-                })
-                    .strict(),
-            })
-                .strict(),
-        })
-            .strict(),
-    })
-        .strict(),
-    endpoint: '/admin.setupMonitoring',
-});
-// ── export ───────────────────────────────────────────────────────────
-export const adminTools = [setupMonitoring];

package/dist/tools/application.d.ts

@@ -1,2 +0,0 @@
-import { type ToolDefinition } from './_factory.js';
-export declare const applicationTools: ToolDefinition[];