@tmhs/docker-mcp 0.4.0

package/dist/utils/docker-api.js

@@ -0,0 +1,82 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { DockerError, DockerNotFoundError, DockerNotRunningError, ContainerNotFoundError, ImageNotFoundError, PermissionDeniedError, } from "./errors.js";
+const execFileAsync = promisify(execFile);
+const EXEC_TIMEOUT_MS = 30_000;
+export async function checkDockerAvailable() {
+    try {
+        await execFileAsync("docker", ["version", "--format", "json"], {
+            timeout: EXEC_TIMEOUT_MS,
+        });
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === "ENOENT") {
+            throw new DockerNotFoundError();
+        }
+        if (err.stderr?.includes("Cannot connect") ||
+            err.stderr?.includes("Is the docker daemon running")) {
+            throw new DockerNotRunningError();
+        }
+        if (err.stderr?.includes("permission denied") ||
+            err.stderr?.includes("Permission denied")) {
+            throw new PermissionDeniedError();
+        }
+        throw new DockerError(`Docker check failed: ${err.message}`);
+    }
+}
+export async function execDocker(args, options = {}) {
+    const { timeout = EXEC_TIMEOUT_MS } = options;
+    try {
+        const { stdout, stderr } = await execFileAsync("docker", args, {
+            timeout,
+            maxBuffer: 10 * 1024 * 1024,
+        });
+        if (stderr && !stdout) {
+            throw new DockerError(stderr.trim());
+        }
+        return stdout;
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === "ENOENT") {
+            throw new DockerNotFoundError();
+        }
+        const stderr = err.stderr ?? err.message ?? "";
+        if (stderr.includes("Cannot connect") ||
+            stderr.includes("Is the docker daemon running")) {
+            throw new DockerNotRunningError();
+        }
+        if (stderr.includes("permission denied") ||
+            stderr.includes("Permission denied")) {
+            throw new PermissionDeniedError();
+        }
+        if (stderr.includes("No such container")) {
+            const match = stderr.match(/No such container:\s*(\S+)/);
+            throw new ContainerNotFoundError(match?.[1] ?? "unknown");
+        }
+        if (stderr.includes("No such image") ||
+            stderr.includes("reference does not exist")) {
+            const match = stderr.match(/No such image:\s*(\S+)/);
+            throw new ImageNotFoundError(match?.[1] ?? "unknown");
+        }
+        throw new DockerError(stderr.trim() || err.message, undefined, args[0]);
+    }
+}
+export function parseJsonLines(output) {
+    const lines = output.trim().split("\n").filter(Boolean);
+    return lines.map((line) => JSON.parse(line));
+}
+export function errorResponse(error) {
+    if (error instanceof Error) {
+        return {
+            content: [{ type: "text", text: error.message }],
+            isError: true,
+        };
+    }
+    return {
+        content: [{ type: "text", text: "An unknown error occurred." }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=docker-api.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docker-api.js","sourceRoot":"","sources":["../../src/utils/docker-api.ts"],"names":[],"mappings":"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"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,23 @@
+export declare class DockerError extends Error {
+    readonly statusCode?: number;
+    readonly command?: string;
+    constructor(message: string, statusCode?: number, command?: string);
+}
+export declare class DockerNotFoundError extends DockerError {
+    constructor();
+}
+export declare class DockerNotRunningError extends DockerError {
+    constructor();
+}
+export declare class ContainerNotFoundError extends DockerError {
+    readonly containerId: string;
+    constructor(containerId: string);
+}
+export declare class ImageNotFoundError extends DockerError {
+    readonly imageRef: string;
+    constructor(imageRef: string);
+}
+export declare class PermissionDeniedError extends DockerError {
+    constructor();
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAMnE;AAED,qBAAa,mBAAoB,SAAQ,WAAW;;CAOnD;AAED,qBAAa,qBAAsB,SAAQ,WAAW;;CAOrD;AAED,qBAAa,sBAAuB,SAAQ,WAAW;IACrD,SAAgB,WAAW,EAAE,MAAM,CAAC;gBAExB,WAAW,EAAE,MAAM;CAKhC;AAED,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,SAAgB,QAAQ,EAAE,MAAM,CAAC;gBAErB,QAAQ,EAAE,MAAM;CAK7B;AAED,qBAAa,qBAAsB,SAAQ,WAAW;;CAOrD"}

package/dist/utils/errors.js

@@ -0,0 +1,45 @@
+export class DockerError extends Error {
+    statusCode;
+    command;
+    constructor(message, statusCode, command) {
+        super(message);
+        this.name = "DockerError";
+        this.statusCode = statusCode;
+        this.command = command;
+    }
+}
+export class DockerNotFoundError extends DockerError {
+    constructor() {
+        super("Docker CLI not found. Make sure Docker is installed and the 'docker' command is available on your PATH.");
+        this.name = "DockerNotFoundError";
+    }
+}
+export class DockerNotRunningError extends DockerError {
+    constructor() {
+        super("Docker daemon is not running. Start Docker Desktop or the Docker service and try again.");
+        this.name = "DockerNotRunningError";
+    }
+}
+export class ContainerNotFoundError extends DockerError {
+    containerId;
+    constructor(containerId) {
+        super(`Container not found: ${containerId}`);
+        this.name = "ContainerNotFoundError";
+        this.containerId = containerId;
+    }
+}
+export class ImageNotFoundError extends DockerError {
+    imageRef;
+    constructor(imageRef) {
+        super(`Image not found: ${imageRef}`);
+        this.name = "ImageNotFoundError";
+        this.imageRef = imageRef;
+    }
+}
+export class PermissionDeniedError extends DockerError {
+    constructor() {
+        super("Permission denied. You may need to run Docker with elevated privileges or add your user to the 'docker' group.");
+        this.name = "PermissionDeniedError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpB,UAAU,CAAU;IACpB,OAAO,CAAU;IAEjC,YAAY,OAAe,EAAE,UAAmB,EAAE,OAAgB;QAChE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAClD;QACE,KAAK,CACH,yGAAyG,CAC1G,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,WAAW;IACpD;QACE,KAAK,CACH,yFAAyF,CAC1F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,WAAW;IACrC,WAAW,CAAS;IAEpC,YAAY,WAAmB;QAC7B,KAAK,CAAC,wBAAwB,WAAW,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IACjC,QAAQ,CAAS;IAEjC,YAAY,QAAgB;QAC1B,KAAK,CAAC,oBAAoB,QAAQ,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,WAAW;IACpD;QACE,KAAK,CACH,gHAAgH,CACjH,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@tmhs/docker-mcp",
+  "version": "0.4.0",
+  "description": "MCP server for Docker CLI integration - 36 tools for containers, images, compose, volumes, networks, and system info. Full container lifecycle, image pipeline, and Compose V2 management.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "docker-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">= 20.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3",
+    "vitest": "^4.1.2"
+  },
+  "license": "CC-BY-NC-ND-4.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TMHSDigital/Docker-Developer-Tools.git",
+    "directory": "mcp-server"
+  },
+  "homepage": "https://github.com/TMHSDigital/Docker-Developer-Tools",
+  "bugs": {
+    "url": "https://github.com/TMHSDigital/Docker-Developer-Tools/issues"
+  },
+  "author": "TMHSDigital"
+}