@hypnosis/docker-mcp-server 1.0.4 → 1.3.0

package/dist/utils/compose-exec.d.ts

@@ -2,12 +2,37 @@
  * Compose Exec
  * CLI wrapper для docker-compose команд
  */
+import type { SSHConfig } from './ssh-config.js';
+export interface ComposeExecOptions {
+    /** Рабочая директория */
+    cwd?: string;
+    /** SSH конфигурация для удаленного Docker */
+    sshConfig?: SSHConfig | null;
+    /** Docker context (альтернатива SSH config) */
+    dockerContext?: string;
+}
 export declare class ComposeExec {
     /**
      * Выполнить docker-compose команду
+     * Поддерживает SSH через DOCKER_HOST или Docker context
+     */
+    static run(composeFile: string, args: string[], options?: ComposeExecOptions): string;
+    /**
+     * Подготовить переменные окружения для выполнения команды
+     * Если указан SSH config, устанавливает DOCKER_HOST для удаленного Docker
+     */
+    private static prepareEnvironment;
+    /**
+     * Создать Docker context для SSH подключения
+     * Используется как альтернатива DOCKER_HOST
+     *
+     * Примечание: Эта функция создает контекст через Docker CLI.
+     * Требует наличия Docker CLI и SSH доступа.
+     */
+    static createDockerContext(contextName: string, sshConfig: SSHConfig): Promise<void>;
+    /**
+     * Проверить существование Docker context
      */
-    static run(composeFile: string, args: string[], options?: {
-        cwd?: string;
-    }): string;
+    static contextExists(contextName: string): Promise<boolean>;
 }
 //# sourceMappingURL=compose-exec.d.ts.map

package/dist/utils/compose-exec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compose-exec.d.ts","sourceRoot":"","sources":["../../src/utils/compose-exec.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,qBAAa,WAAW;IACtB;;OAEG;IACH,MAAM,CAAC,GAAG,CACR,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAO,GAC7B,MAAM;CA0CV"}
+{"version":3,"file":"compose-exec.d.ts","sourceRoot":"","sources":["../../src/utils/compose-exec.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,WAAW;IACtB;;;OAGG;IACH,MAAM,CAAC,GAAG,CACR,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,kBAAuB,GAC/B,MAAM;IAuDT;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAajC;;;;;;OAMG;WACU,mBAAmB,CAC9B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,IAAI,CAAC;IA4BhB;;OAEG;WACU,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAuBlE"}

package/dist/utils/compose-exec.js

@@ -2,46 +2,120 @@
  * Compose Exec
  * CLI wrapper для docker-compose команд
  */
-import { execSync } from 'child_process';
+import { spawnSync } from 'child_process';
 import { logger } from './logger.js';
 export class ComposeExec {
     /**
      * Выполнить docker-compose команду
+     * Поддерживает SSH через DOCKER_HOST или Docker context
      */
     static run(composeFile, args, options = {}) {
-        // Строим команду: docker-compose -f <file> <args>
-        const cmd = `docker-compose -f ${composeFile} ${args.join(' ')}`;
-        logger.debug(`Executing docker-compose: ${cmd}`);
+        // Используем docker compose (v2) вместо docker-compose (v1)
+        // docker compose работает везде, docker-compose может отсутствовать
+        let cmd = `docker compose -f ${composeFile}`;
+        // Добавляем Docker context (если указан)
+        if (options.dockerContext) {
+            cmd = `docker compose --context ${options.dockerContext} -f ${composeFile}`;
+            logger.debug(`Using Docker context: ${options.dockerContext}`);
+        }
+        cmd = `${cmd} ${args.join(' ')}`;
+        logger.debug(`Executing docker compose: ${cmd}`);
         if (options.cwd) {
             logger.debug(`Working directory: ${options.cwd}`);
         }
+        // Подготавливаем окружение для выполнения команды
+        const env = this.prepareEnvironment(options.sshConfig);
+        // Разбиваем команду на части для spawnSync
+        const [command, ...commandArgs] = cmd.split(' ');
+        const result = spawnSync(command, commandArgs, {
+            cwd: options.cwd,
+            env: env,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        // Проверяем exit code
+        if (result.status !== 0 && result.status !== null) {
+            // Команда завершилась с ошибкой
+            let errorMessage = result.stderr || result.stdout || 'Unknown error';
+            // Если есть stdout, добавляем его к сообщению
+            if (result.stdout && result.stdout.trim()) {
+                errorMessage = `${errorMessage}\n${result.stdout}`;
+            }
+            logger.error('docker compose command failed:', {
+                status: result.status,
+                stderr: result.stderr,
+                stdout: result.stdout,
+            });
+            throw new Error(`docker compose failed: ${errorMessage}`);
+        }
+        // Команда выполнена успешно (status === 0 или null)
+        // Возвращаем stdout, игнорируя stderr (он может содержать предупреждения)
+        return result.stdout || '';
+    }
+    /**
+     * Подготовить переменные окружения для выполнения команды
+     * Если указан SSH config, устанавливает DOCKER_HOST для удаленного Docker
+     */
+    static prepareEnvironment(sshConfig) {
+        const env = { ...process.env };
+        // Если указан SSH config, устанавливаем DOCKER_HOST
+        if (sshConfig) {
+            const dockerHost = `ssh://${sshConfig.username}@${sshConfig.host}:${sshConfig.port || 22}`;
+            env.DOCKER_HOST = dockerHost;
+            logger.debug(`Setting DOCKER_HOST=${dockerHost} for docker-compose`);
+        }
+        return env;
+    }
+    /**
+     * Создать Docker context для SSH подключения
+     * Используется как альтернатива DOCKER_HOST
+     *
+     * Примечание: Эта функция создает контекст через Docker CLI.
+     * Требует наличия Docker CLI и SSH доступа.
+     */
+    static async createDockerContext(contextName, sshConfig) {
+        const dockerHost = `ssh://${sshConfig.username}@${sshConfig.host}:${sshConfig.port || 22}`;
+        const cmd = `docker context create ${contextName} --docker "host=${dockerHost}"`;
+        logger.debug(`Creating Docker context: ${cmd}`);
+        const [command, ...args] = cmd.split(' ');
+        const result = spawnSync(command, args, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        if (result.status !== 0 && result.status !== null) {
+            const errorMessage = result.stderr || result.stdout || 'Unknown error';
+            // Если контекст уже существует, это не критично
+            if (errorMessage.includes('already exists')) {
+                logger.warn(`Docker context "${contextName}" already exists`);
+                return;
+            }
+            logger.error(`Failed to create Docker context: ${errorMessage}`);
+            throw new Error(`Failed to create Docker context "${contextName}": ${errorMessage}`);
+        }
+        logger.info(`Docker context "${contextName}" created successfully`);
+    }
+    /**
+     * Проверить существование Docker context
+     */
+    static async contextExists(contextName) {
         try {
-            const output = execSync(cmd, {
-                cwd: options.cwd,
+            const result = spawnSync('docker', ['context', 'ls', '--format', 'json'], {
                 encoding: 'utf-8',
                 stdio: ['pipe', 'pipe', 'pipe'],
             });
-            return output;
-        }
-        catch (error) {
-            logger.error('docker-compose command failed:', error);
-            // Извлекаем полное сообщение об ошибке (включая stderr)
-            let errorMessage = error.message || String(error);
-            // Если есть stderr, добавляем его к сообщению
-            if (error.stderr) {
-                const stderr = error.stderr.toString ? error.stderr.toString() : String(error.stderr);
-                if (stderr && !errorMessage.includes(stderr)) {
-                    errorMessage = `${errorMessage}\n${stderr}`;
-                }
+            if (result.status !== 0 && result.status !== null) {
+                return false;
             }
-            // Если есть stdout (может содержать полезную информацию)
-            if (error.stdout) {
-                const stdout = error.stdout.toString ? error.stdout.toString() : String(error.stdout);
-                if (stdout && stdout.trim()) {
-                    errorMessage = `${errorMessage}\n${stdout}`;
-                }
-            }
-            throw new Error(`docker-compose failed: ${errorMessage}`);
+            const output = result.stdout || '';
+            const contexts = output
+                .trim()
+                .split('\n')
+                .filter((line) => line.trim())
+                .map((line) => JSON.parse(line));
+            return contexts.some((ctx) => ctx.Name === contextName);
+        }
+        catch {
+            return false;
         }
     }
 }

package/dist/utils/compose-exec.js.map

@@ -1 +1 @@
-{"version":3,"file":"compose-exec.js","sourceRoot":"","sources":["../../src/utils/compose-exec.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,OAAO,WAAW;IACtB;;OAEG;IACH,MAAM,CAAC,GAAG,CACR,WAAmB,EACnB,IAAc,EACd,UAA4B,EAAE;QAE9B,kDAAkD;QAClD,MAAM,GAAG,GAAG,qBAAqB,WAAW,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAEjE,MAAM,CAAC,KAAK,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;QACjD,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,MAAM,CAAC,KAAK,CAAC,sBAAsB,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE;gBAC3B,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,QAAQ,EAAE,OAAO;gBACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;aAChC,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;YAEtD,wDAAwD;YACxD,IAAI,YAAY,GAAG,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;YAElD,8CAA8C;YAC9C,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACtF,IAAI,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC7C,YAAY,GAAG,GAAG,YAAY,KAAK,MAAM,EAAE,CAAC;gBAC9C,CAAC;YACH,CAAC;YAED,yDAAyD;YACzD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACtF,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;oBAC5B,YAAY,GAAG,GAAG,YAAY,KAAK,MAAM,EAAE,CAAC;gBAC9C,CAAC;YACH,CAAC;YAED,MAAM,IAAI,KAAK,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"compose-exec.js","sourceRoot":"","sources":["../../src/utils/compose-exec.ts"],"names":[],"mappings":"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"}

package/dist/utils/docker-client.d.ts

@@ -1,33 +1,106 @@
 /**
  * Docker Client Wrapper
- * Обёртка над Dockerode для централизованного управления
+ * Centralized Docker API management with SSH tunnel support
  */
 import Docker from 'dockerode';
+import type { SSHConfig } from './ssh-config.js';
 /**
- * Wrapper над Dockerode для централизованного управления
+ * Dockerode wrapper for centralized Docker API management
  */
 export declare class DockerClient {
     private docker;
-    constructor();
+    private sshConfig;
+    readonly isRemote: boolean;
+    private activeSocketPath;
+    private sshProcessPid;
+    private tunnelCreationLock;
+    private tunnelHealthCheckInterval;
+    constructor(sshConfig?: SSHConfig | null);
+    /**
+     * Get SSH config for comparison
+     */
+    getSSHConfig(): SSHConfig | null;
+    /**
+     * Get SSH host for identification
+     */
+    getSSHHost(): string | null;
+    /**
+     * Cleanup SSH tunnel (called on shutdown)
+     */
+    cleanup(): void;
+    /**
+     * Ensure SSH tunnel is created and recreate Docker client with correct socket
+     * With mutex to prevent race conditions
+     */
+    private ensureSSHTunnel;
+    /**
+     * Start periodic healthcheck for SSH tunnel
+     */
+    private startTunnelHealthCheck;
+    /**
+     * Create SSH tunnel to remote Docker socket
+     * @returns Path to local socket file
+     */
+    private createSSHTunnel;
+    /**
+     * Wait for socket file creation
+     */
+    private waitForSocket;
+    /**
+     * Resolve SSH key path (support for ~)
+     */
+    private resolveKeyPath;
     /**
      * Проверка подключения к Docker
+     * С retry логикой для удаленных подключений
      */
     ping(): Promise<void>;
     /**
-     * Получить native Dockerode instance
+     * Get native Dockerode instance
      */
     getClient(): Docker;
     /**
-     * Список контейнеров
+     * List containers
+     * With retry logic for remote connections
      */
     listContainers(options?: Docker.ContainerListOptions): Promise<Docker.ContainerInfo[]>;
     /**
-     * Получить контейнер по ID или имени
+     * Get container by ID or name
      */
     getContainer(id: string): Docker.Container;
 }
 /**
- * Получить singleton instance DockerClient
+ * Get singleton instance of DockerClient
+ * @param sshConfig - SSH configuration (optional, for remote Docker)
+ */
+export declare function getDockerClient(sshConfig?: SSHConfig | null): DockerClient;
+/**
+ * Reset singleton instance (for testing)
+ */
+export declare function resetDockerClient(): void;
+/**
+ * Cleanup all Docker clients (for graceful shutdown)
+ */
+export declare function cleanupDockerClient(): void;
+/**
+ * Get Docker client for specific profile
+ * @param profileName - Profile name (undefined = local Docker)
+ * @returns DockerClient instance
+ *
+ * @example
+ * // Local Docker (default)
+ * const localClient = getDockerClientForProfile();
+ *
+ * // Remote Docker (production profile)
+ * const prodClient = getDockerClientForProfile('production');
+ */
+export declare function getDockerClientForProfile(profileName?: string): DockerClient;
+/**
+ * Clear client pool (for testing or cleanup)
+ */
+export declare function clearClientPool(): void;
+/**
+ * Cleanup all Docker clients in pool (for graceful shutdown)
  */
-export declare function getDockerClient(): DockerClient;
+export declare function cleanupAllDockerClients(): void;
 //# sourceMappingURL=docker-client.d.ts.map

package/dist/utils/docker-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docker-client.d.ts","sourceRoot":"","sources":["../../src/utils/docker-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,MAAM,MAAM,WAAW,CAAC;AAG/B;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;;IAOvB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,oBAAoB;IAI1D;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,SAAS;CAG3C;AAKD;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAK9C"}
+{"version":3,"file":"docker-client.d.ts","sourceRoot":"","sources":["../../src/utils/docker-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,MAAM,MAAM,WAAW,CAAC;AAM/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAmB;IACpC,SAAgB,QAAQ,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,kBAAkB,CAAgC;IAC1D,OAAO,CAAC,yBAAyB,CAA+B;gBAEpD,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI;IAgBxC;;OAEG;IACH,YAAY,IAAI,SAAS,GAAG,IAAI;IAIhC;;OAEG;IACH,UAAU,IAAI,MAAM,GAAG,IAAI;IAI3B;;OAEG;IACH,OAAO,IAAI,IAAI;IAuCf;;;OAGG;YACW,eAAe;IA6C7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAoC9B;;;OAGG;YACW,eAAe;IAuI7B;;OAEG;YACW,aAAa;IAiB3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC3B;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;;OAGG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,oBAAoB;IAsB1D;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,SAAS;CAG3C;AAKD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,YAAY,CA6B1E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C;AAoED;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,YAAY,CA4B5E;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAyBtC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAM9C"}