@hypnosis/docker-mcp-server 1.0.0

package/dist/tools/mcp-health-tool.js

@@ -0,0 +1,126 @@
+/**
+ * MCP Health Tool
+ * Самодиагностика MCP сервера
+ */
+import { getDockerClient } from '../utils/docker-client.js';
+import { ProjectDiscovery } from '../discovery/project-discovery.js';
+import { adapterRegistry } from '../adapters/adapter-registry.js';
+import { projectConfigCache } from '../utils/cache.js';
+import { logger } from '../utils/logger.js';
+export class MCPHealthTool {
+    /**
+     * Регистрация health tool
+     */
+    getTool() {
+        return {
+            name: 'docker_mcp_health',
+            description: 'Check health status of the MCP server (self-diagnostics)',
+            inputSchema: {
+                type: 'object',
+                properties: {},
+            },
+        };
+    }
+    /**
+     * Обработка вызова tool
+     */
+    async handleCall(request) {
+        try {
+            const healthStatus = await this.check();
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(healthStatus, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error('MCP health check failed:', error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    /**
+     * Выполнить проверки здоровья
+     */
+    async check() {
+        const checks = {};
+        // 1. Docker Connection
+        try {
+            const start = Date.now();
+            const docker = getDockerClient();
+            await docker.ping();
+            const latency = Date.now() - start;
+            checks.docker = {
+                status: 'ok',
+                latency,
+            };
+        }
+        catch (error) {
+            checks.docker = {
+                status: 'failed',
+                message: error.message || 'Docker connection failed',
+            };
+        }
+        // 2. Project Discovery
+        try {
+            const projectDiscovery = new ProjectDiscovery();
+            const project = await projectDiscovery.findProject();
+            checks.discovery = {
+                status: 'ok',
+                projectFound: true,
+                projectName: project.name,
+            };
+        }
+        catch (error) {
+            checks.discovery = {
+                status: 'failed',
+                message: error.message || 'Project discovery failed',
+                projectFound: false,
+            };
+        }
+        // 3. Adapters Registry
+        const registeredTypes = adapterRegistry.getRegisteredTypes();
+        checks.adapters = {
+            status: 'ok',
+            registered: registeredTypes,
+            count: registeredTypes.length,
+        };
+        // 4. Cache Status
+        checks.cache = {
+            status: 'ok',
+            size: projectConfigCache.size(),
+            ttl: 60, // seconds (hardcoded, так как в Cache не экспортирован)
+        };
+        // 5. Memory Usage
+        const mem = process.memoryUsage();
+        const heapUsedMB = Math.round(mem.heapUsed / 1024 / 1024);
+        const heapTotalMB = Math.round(mem.heapTotal / 1024 / 1024);
+        const rssMB = Math.round(mem.rss / 1024 / 1024);
+        checks.memory = {
+            status: heapUsedMB > 500 ? 'warning' : 'ok',
+            heapUsed: heapUsedMB,
+            heapTotal: heapTotalMB,
+            rss: rssMB,
+        };
+        // Overall status
+        const hasFailures = Object.values(checks).some((check) => check.status === 'failed');
+        const hasWarnings = Object.values(checks).some((check) => check.status === 'warning');
+        return {
+            status: hasFailures ? 'unhealthy' : hasWarnings ? 'degraded' : 'healthy',
+            timestamp: new Date().toISOString(),
+            uptime: Math.round(process.uptime()), // seconds
+            checks,
+        };
+    }
+}
+//# sourceMappingURL=mcp-health-tool.js.map

package/dist/tools/mcp-health-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-health-tool.js","sourceRoot":"","sources":["../../src/tools/mcp-health-tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,OAAO,aAAa;IACxB;;OAEG;IACH,OAAO;QACL,OAAO;YACL,IAAI,EAAE,mBAAmB;YACzB,WAAW,EAAE,0DAA0D;YACvE,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,EAAE;aACf;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,OAAwB;QACvC,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YAExC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;qBAC5C;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;YAChD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,UAAU,KAAK,CAAC,OAAO,EAAE;qBAChC;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QAkCT,MAAM,MAAM,GAAQ,EAAE,CAAC;QAEvB,uBAAuB;QACvB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;YACjC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YAEnC,MAAM,CAAC,MAAM,GAAG;gBACd,MAAM,EAAE,IAAa;gBACrB,OAAO;aACR,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,CAAC,MAAM,GAAG;gBACd,MAAM,EAAE,QAAiB;gBACzB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,0BAA0B;aACrD,CAAC;QACJ,CAAC;QAED,uBAAuB;QACvB,IAAI,CAAC;YACH,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC;YAChD,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,WAAW,EAAE,CAAC;YAErD,MAAM,CAAC,SAAS,GAAG;gBACjB,MAAM,EAAE,IAAa;gBACrB,YAAY,EAAE,IAAI;gBAClB,WAAW,EAAE,OAAO,CAAC,IAAI;aAC1B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,CAAC,SAAS,GAAG;gBACjB,MAAM,EAAE,QAAiB;gBACzB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,0BAA0B;gBACpD,YAAY,EAAE,KAAK;aACpB,CAAC;QACJ,CAAC;QAED,uBAAuB;QACvB,MAAM,eAAe,GAAG,eAAe,CAAC,kBAAkB,EAAE,CAAC;QAC7D,MAAM,CAAC,QAAQ,GAAG;YAChB,MAAM,EAAE,IAAa;YACrB,UAAU,EAAE,eAAe;YAC3B,KAAK,EAAE,eAAe,CAAC,MAAM;SAC9B,CAAC;QAEF,kBAAkB;QAClB,MAAM,CAAC,KAAK,GAAG;YACb,MAAM,EAAE,IAAa;YACrB,IAAI,EAAE,kBAAkB,CAAC,IAAI,EAAE;YAC/B,GAAG,EAAE,EAAE,EAAE,wDAAwD;SAClE,CAAC;QAEF,kBAAkB;QAClB,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;QAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;QAEhD,MAAM,CAAC,MAAM,GAAG;YACd,MAAM,EAAE,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,SAAkB,CAAC,CAAC,CAAC,IAAa;YAC7D,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,WAAW;YACtB,GAAG,EAAE,KAAK;SACX,CAAC;QAEF,iBAAiB;QACjB,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAC5C,CAAC,KAAU,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ,CAC1C,CAAC;QACF,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAC5C,CAAC,KAAU,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAC3C,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;YACxE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,UAAU;YAChD,MAAM;SACP,CAAC;IACJ,CAAC;CACF"}

package/dist/utils/cache.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Cache utility
+ * Кеширование с TTL (Time To Live)
+ */
+import type { ProjectConfig } from '../discovery/types.js';
+/**
+ * Generic cache с TTL
+ */
+export declare class Cache<T> {
+    private cache;
+    private ttl;
+    constructor(ttlSeconds?: number);
+    /**
+     * Установить значение в кеш
+     */
+    set(key: string, value: T): void;
+    /**
+     * Получить значение из кеша
+     * Возвращает undefined если ключ не найден или истек TTL
+     */
+    get(key: string): T | undefined;
+    /**
+     * Инвалидировать ключ
+     */
+    invalidate(key: string): void;
+    /**
+     * Очистить весь кеш
+     */
+    clear(): void;
+    /**
+     * Проверить наличие ключа (без проверки TTL)
+     */
+    has(key: string): boolean;
+    /**
+     * Получить размер кеша
+     */
+    size(): number;
+}
+/**
+ * Singleton для ProjectConfig кеша (TTL: 60 секунд)
+ */
+export declare const projectConfigCache: Cache<ProjectConfig>;
+//# sourceMappingURL=cache.d.ts.map

package/dist/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAQ3D;;GAEG;AACH,qBAAa,KAAK,CAAC,CAAC;IAClB,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,GAAG,CAAS;gBAER,UAAU,GAAE,MAAW;IAInC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAQhC;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAmB/B;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAM7B;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACH,IAAI,IAAI,MAAM;CAGf;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,sBAA+B,CAAC"}

package/dist/utils/cache.js

@@ -0,0 +1,77 @@
+/**
+ * Cache utility
+ * Кеширование с TTL (Time To Live)
+ */
+import { logger } from './logger.js';
+/**
+ * Generic cache с TTL
+ */
+export class Cache {
+    cache = new Map();
+    ttl; // milliseconds
+    constructor(ttlSeconds = 60) {
+        this.ttl = ttlSeconds * 1000;
+    }
+    /**
+     * Установить значение в кеш
+     */
+    set(key, value) {
+        this.cache.set(key, {
+            value,
+            expiresAt: Date.now() + this.ttl,
+        });
+        logger.debug(`Cache set: ${key} (TTL: ${this.ttl / 1000}s)`);
+    }
+    /**
+     * Получить значение из кеша
+     * Возвращает undefined если ключ не найден или истек TTL
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            logger.debug(`Cache miss: ${key}`);
+            return undefined;
+        }
+        // Проверка TTL
+        if (Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            logger.debug(`Cache expired: ${key}`);
+            return undefined;
+        }
+        logger.debug(`Cache hit: ${key}`);
+        return entry.value;
+    }
+    /**
+     * Инвалидировать ключ
+     */
+    invalidate(key) {
+        if (this.cache.delete(key)) {
+            logger.debug(`Cache invalidated: ${key}`);
+        }
+    }
+    /**
+     * Очистить весь кеш
+     */
+    clear() {
+        const size = this.cache.size;
+        this.cache.clear();
+        logger.debug(`Cache cleared (${size} entries)`);
+    }
+    /**
+     * Проверить наличие ключа (без проверки TTL)
+     */
+    has(key) {
+        return this.cache.has(key);
+    }
+    /**
+     * Получить размер кеша
+     */
+    size() {
+        return this.cache.size;
+    }
+}
+/**
+ * Singleton для ProjectConfig кеша (TTL: 60 секунд)
+ */
+export const projectConfigCache = new Cache(60);
+//# sourceMappingURL=cache.js.map

package/dist/utils/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAOrC;;GAEG;AACH,MAAM,OAAO,KAAK;IACR,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IACzC,GAAG,CAAS,CAAC,eAAe;IAEpC,YAAY,aAAqB,EAAE;QACjC,IAAI,CAAC,GAAG,GAAG,UAAU,GAAG,IAAI,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAW,EAAE,KAAQ;QACvB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG;SACjC,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,cAAc,GAAG,UAAU,IAAI,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,CAAC;IAC/D,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,GAAW;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAElC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,CAAC,KAAK,CAAC,eAAe,GAAG,EAAE,CAAC,CAAC;YACnC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,eAAe;QACf,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,MAAM,CAAC,KAAK,CAAC,kBAAkB,GAAG,EAAE,CAAC,CAAC;YACtC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,cAAc,GAAG,EAAE,CAAC,CAAC;QAClC,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,GAAW;QACpB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,KAAK,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,CAAC,KAAK,CAAC,kBAAkB,IAAI,WAAW,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,KAAK,CAAgB,EAAE,CAAC,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Compose Exec
+ * CLI wrapper для docker-compose команд
+ */
+export declare class ComposeExec {
+    /**
+     * Выполнить docker-compose команду
+     */
+    static run(composeFile: string, args: string[], options?: {
+        cwd?: string;
+    }): string;
+}
+//# sourceMappingURL=compose-exec.d.ts.map

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

@@ -0,0 +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;CAuBV"}

package/dist/utils/compose-exec.js

@@ -0,0 +1,33 @@
+/**
+ * Compose Exec
+ * CLI wrapper для docker-compose команд
+ */
+import { execSync } from 'child_process';
+import { logger } from './logger.js';
+export class ComposeExec {
+    /**
+     * Выполнить docker-compose команду
+     */
+    static run(composeFile, args, options = {}) {
+        // Строим команду: docker-compose -f <file> <args>
+        const cmd = `docker-compose -f ${composeFile} ${args.join(' ')}`;
+        logger.debug(`Executing docker-compose: ${cmd}`);
+        if (options.cwd) {
+            logger.debug(`Working directory: ${options.cwd}`);
+        }
+        try {
+            const output = execSync(cmd, {
+                cwd: options.cwd,
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            return output;
+        }
+        catch (error) {
+            logger.error('docker-compose command failed:', error);
+            const errorMessage = error.message || String(error);
+            throw new Error(`docker-compose failed: ${errorMessage}`);
+        }
+    }
+}
+//# sourceMappingURL=compose-exec.js.map

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

@@ -0,0 +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;YACtD,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,33 @@
+/**
+ * Docker Client Wrapper
+ * Обёртка над Dockerode для централизованного управления
+ */
+import Docker from 'dockerode';
+/**
+ * Wrapper над Dockerode для централизованного управления
+ */
+export declare class DockerClient {
+    private docker;
+    constructor();
+    /**
+     * Проверка подключения к Docker
+     */
+    ping(): Promise<void>;
+    /**
+     * Получить native Dockerode instance
+     */
+    getClient(): Docker;
+    /**
+     * Список контейнеров
+     */
+    listContainers(options?: Docker.ContainerListOptions): Promise<Docker.ContainerInfo[]>;
+    /**
+     * Получить контейнер по ID или имени
+     */
+    getContainer(id: string): Docker.Container;
+}
+/**
+ * Получить singleton instance DockerClient
+ */
+export declare function getDockerClient(): DockerClient;
+//# sourceMappingURL=docker-client.d.ts.map

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

@@ -0,0 +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"}

package/dist/utils/docker-client.js

@@ -0,0 +1,59 @@
+/**
+ * Docker Client Wrapper
+ * Обёртка над Dockerode для централизованного управления
+ */
+import Docker from 'dockerode';
+import { logger } from './logger.js';
+/**
+ * Wrapper над Dockerode для централизованного управления
+ */
+export class DockerClient {
+    docker;
+    constructor() {
+        this.docker = new Docker();
+        logger.debug('Dockerode client initialized');
+    }
+    /**
+     * Проверка подключения к Docker
+     */
+    async ping() {
+        try {
+            await this.docker.ping();
+            logger.info('Docker connection verified');
+        }
+        catch (error) {
+            logger.error('Docker connection failed:', error);
+            throw new Error('Docker is not running. Please start Docker Desktop and try again.');
+        }
+    }
+    /**
+     * Получить native Dockerode instance
+     */
+    getClient() {
+        return this.docker;
+    }
+    /**
+     * Список контейнеров
+     */
+    async listContainers(options) {
+        return this.docker.listContainers(options);
+    }
+    /**
+     * Получить контейнер по ID или имени
+     */
+    getContainer(id) {
+        return this.docker.getContainer(id);
+    }
+}
+// Singleton instance
+let dockerClientInstance = null;
+/**
+ * Получить singleton instance DockerClient
+ */
+export function getDockerClient() {
+    if (!dockerClientInstance) {
+        dockerClientInstance = new DockerClient();
+    }
+    return dockerClientInstance;
+}
+//# sourceMappingURL=docker-client.js.map

package/dist/utils/docker-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-client.js","sourceRoot":"","sources":["../../src/utils/docker-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,MAAM,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;GAEG;AACH,MAAM,OAAO,YAAY;IACf,MAAM,CAAS;IAEvB;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;YACjD,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,OAAqC;QACxD,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,EAAU;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC;CACF;AAED,qBAAqB;AACrB,IAAI,oBAAoB,GAAwB,IAAI,CAAC;AAErD;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC1B,oBAAoB,GAAG,IAAI,YAAY,EAAE,CAAC;IAC5C,CAAC;IACD,OAAO,oBAAoB,CAAC;AAC9B,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Logger для MCP Server
+ * Выводит в stderr (stdout занят MCP протоколом)
+ */
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+declare class Logger {
+    private level;
+    constructor(level?: LogLevel);
+    private shouldLog;
+    private log;
+    debug(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,KAAK,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpD,cAAM,MAAM;IACV,OAAO,CAAC,KAAK,CAAoB;gBAErB,KAAK,CAAC,EAAE,QAAQ;IAI5B,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,GAAG;IAUX,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI3C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI3C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;CAG7C;AAGD,eAAO,MAAM,MAAM,QAElB,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,38 @@
+/**
+ * Logger для MCP Server
+ * Выводит в stderr (stdout занят MCP протоколом)
+ */
+class Logger {
+    level = 'info';
+    constructor(level) {
+        if (level)
+            this.level = level;
+    }
+    shouldLog(level) {
+        const levels = ['debug', 'info', 'warn', 'error'];
+        return levels.indexOf(level) >= levels.indexOf(this.level);
+    }
+    log(level, message, ...args) {
+        if (!this.shouldLog(level))
+            return;
+        const timestamp = new Date().toISOString();
+        const prefix = `[${timestamp}] [${level.toUpperCase()}]`;
+        // MCP: stdout для протокола, stderr для логов
+        console.error(prefix, message, ...args);
+    }
+    debug(message, ...args) {
+        this.log('debug', message, ...args);
+    }
+    info(message, ...args) {
+        this.log('info', message, ...args);
+    }
+    warn(message, ...args) {
+        this.log('warn', message, ...args);
+    }
+    error(message, ...args) {
+        this.log('error', message, ...args);
+    }
+}
+// Singleton instance
+export const logger = new Logger(process.env.LOG_LEVEL || 'info');
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,MAAM;IACF,KAAK,GAAa,MAAM,CAAC;IAEjC,YAAY,KAAgB;QAC1B,IAAI,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IAChC,CAAC;IAEO,SAAS,CAAC,KAAe;QAC/B,MAAM,MAAM,GAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9D,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC;IAEO,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,GAAG,IAAW;QAC1D,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YAAE,OAAO;QAEnC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,SAAS,MAAM,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC;QAEzD,8CAA8C;QAC9C,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAW;QACnC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QAClC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QAClC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAW;QACnC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,CAAC;CACF;AAED,qBAAqB;AACrB,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,CAC7B,OAAO,CAAC,GAAG,CAAC,SAAsB,IAAI,MAAM,CAC9C,CAAC"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@hypnosis/docker-mcp-server",
+  "version": "1.0.0",
+  "description": "Universal Docker MCP server for AI assistants (Cursor, Claude Desktop)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "docker-mcp-server": "dist/index.js",
+    "docker-mcp-server-cli": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build && npm test",
+    "publish:dry": "npm pack --dry-run",
+    "publish:check": "npm pack && tar -tzf *.tgz | head -20 && rm -f *.tgz",
+    "publish:npm": "npm publish --access public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.6.0",
+    "dockerode": "^4.0.2",
+    "dotenv": "^16.4.5",
+    "yaml": "^2.3.4"
+  },
+  "devDependencies": {
+    "@types/dockerode": "^3.3.31",
+    "@types/node": "^20.11.0",
+    "@vitest/coverage-v8": "^4.0.16",
+    "@vitest/ui": "^4.0.16",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.16"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "docker",
+    "docker-compose",
+    "cursor",
+    "claude",
+    "ai",
+    "model-context-protocol"
+  ],
+  "author": "Danila Susak <danilasusak@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hypnosis/docker-mcp-server.git"
+  }
+}