@tmhs/docker-mcp 0.4.0

package/LICENSE

@@ -0,0 +1,31 @@
+Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International
+
+Copyright (c) 2026 TM Hospitality Strategies
+
+SPDX-License-Identifier: CC-BY-NC-ND-4.0
+
+You are free to:
+
+  Share - copy and redistribute the material in any medium or format.
+
+The licensor cannot revoke these freedoms as long as you follow the
+license terms.
+
+Under the following terms:
+
+  Attribution - You must give appropriate credit, provide a link to
+  the license, and indicate if changes were made. You may do so in
+  any reasonable manner, but not in any way that suggests the licensor
+  endorses you or your use.
+
+  NonCommercial - You may not use the material for commercial purposes.
+
+  NoDerivatives - If you remix, transform, or build upon the material,
+  you may not distribute the modified material.
+
+  No additional restrictions - You may not apply legal terms or
+  technological measures that legally restrict others from doing
+  anything the license permits.
+
+Full license text:
+https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode

package/README.md

@@ -0,0 +1,111 @@
+# @tmhs/docker-mcp
+
+MCP server for Docker CLI integration - 36 tools for containers, images, Compose, volumes, networks, and system info.
+
+Part of the [Docker Developer Tools](https://github.com/TMHSDigital/Docker-Developer-Tools) Cursor plugin.
+
+## Requirements
+
+- Node.js >= 20
+- Docker CLI (`docker`) available on PATH
+
+## Installation
+
+```bash
+npm install -g @tmhs/docker-mcp
+```
+
+Or run directly with npx:
+
+```bash
+npx @tmhs/docker-mcp
+```
+
+## Cursor MCP Configuration
+
+Add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "docker": {
+      "command": "npx",
+      "args": ["-y", "@tmhs/docker-mcp"]
+    }
+  }
+}
+```
+
+Or if installed globally:
+
+```json
+{
+  "mcpServers": {
+    "docker": {
+      "command": "docker-mcp"
+    }
+  }
+}
+```
+
+## Tools (36)
+
+### Read / Inspect (10)
+
+| Tool | Description |
+|------|-------------|
+| `docker_listContainers` | List running/all containers |
+| `docker_inspectContainer` | Detailed container info |
+| `docker_containerLogs` | Fetch container logs |
+| `docker_listImages` | List local images |
+| `docker_inspectImage` | Detailed image metadata |
+| `docker_listVolumes` | List volumes |
+| `docker_listNetworks` | List networks |
+| `docker_systemInfo` | Docker system info |
+| `docker_diskUsage` | Disk usage breakdown |
+| `docker_searchHub` | Search Docker Hub |
+
+### Container Lifecycle (10)
+
+| Tool | Description |
+|------|-------------|
+| `docker_run` | Create and start a container |
+| `docker_create` | Create a container without starting |
+| `docker_start` | Start a stopped container |
+| `docker_stop` | Stop a running container |
+| `docker_restart` | Restart a container |
+| `docker_kill` | Send a signal to a container |
+| `docker_rm` | Remove a container |
+| `docker_pause` | Pause container processes |
+| `docker_unpause` | Unpause a container |
+| `docker_exec` | Execute a command in a container |
+
+### Image and Build (8)
+
+| Tool | Description |
+|------|-------------|
+| `docker_pull` | Pull an image from a registry |
+| `docker_push` | Push an image to a registry |
+| `docker_build` | Build an image from a Dockerfile |
+| `docker_tag` | Tag an image |
+| `docker_rmi` | Remove images |
+| `docker_commit` | Create image from container changes |
+| `docker_save` | Save images to tar archive |
+| `docker_load` | Load images from tar archive |
+
+### Compose (8)
+
+| Tool | Description |
+|------|-------------|
+| `docker_composeUp` | Create and start Compose services |
+| `docker_composeDown` | Stop and remove Compose services |
+| `docker_composePs` | List Compose project containers |
+| `docker_composeLogs` | View Compose service logs |
+| `docker_composeBuild` | Build Compose service images |
+| `docker_composeRestart` | Restart Compose services |
+| `docker_composePull` | Pull Compose service images |
+| `docker_composeExec` | Execute command in a Compose service |
+
+## License
+
+CC-BY-NC-ND-4.0 - Copyright 2026 TM Hospitality Strategies

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { register as registerListContainers } from "./tools/listContainers.js";
+import { register as registerInspectContainer } from "./tools/inspectContainer.js";
+import { register as registerContainerLogs } from "./tools/containerLogs.js";
+import { register as registerListImages } from "./tools/listImages.js";
+import { register as registerInspectImage } from "./tools/inspectImage.js";
+import { register as registerListVolumes } from "./tools/listVolumes.js";
+import { register as registerListNetworks } from "./tools/listNetworks.js";
+import { register as registerSystemInfo } from "./tools/systemInfo.js";
+import { register as registerDiskUsage } from "./tools/diskUsage.js";
+import { register as registerSearchHub } from "./tools/searchHub.js";
+import { register as registerRun } from "./tools/run.js";
+import { register as registerCreate } from "./tools/create.js";
+import { register as registerStart } from "./tools/start.js";
+import { register as registerStop } from "./tools/stop.js";
+import { register as registerRestart } from "./tools/restart.js";
+import { register as registerKill } from "./tools/kill.js";
+import { register as registerRm } from "./tools/rm.js";
+import { register as registerPause } from "./tools/pause.js";
+import { register as registerUnpause } from "./tools/unpause.js";
+import { register as registerExec } from "./tools/exec.js";
+import { register as registerPull } from "./tools/pull.js";
+import { register as registerPush } from "./tools/push.js";
+import { register as registerBuild } from "./tools/build.js";
+import { register as registerTag } from "./tools/tag.js";
+import { register as registerRmi } from "./tools/rmi.js";
+import { register as registerCommit } from "./tools/commit.js";
+import { register as registerSave } from "./tools/save.js";
+import { register as registerLoad } from "./tools/load.js";
+import { register as registerComposeUp } from "./tools/composeUp.js";
+import { register as registerComposeDown } from "./tools/composeDown.js";
+import { register as registerComposePs } from "./tools/composePs.js";
+import { register as registerComposeLogs } from "./tools/composeLogs.js";
+import { register as registerComposeBuild } from "./tools/composeBuild.js";
+import { register as registerComposeRestart } from "./tools/composeRestart.js";
+import { register as registerComposePull } from "./tools/composePull.js";
+import { register as registerComposeExec } from "./tools/composeExec.js";
+const server = new McpServer({
+    name: "docker-mcp",
+    version: "0.4.0",
+});
+registerListContainers(server);
+registerInspectContainer(server);
+registerContainerLogs(server);
+registerListImages(server);
+registerInspectImage(server);
+registerListVolumes(server);
+registerListNetworks(server);
+registerSystemInfo(server);
+registerDiskUsage(server);
+registerSearchHub(server);
+registerRun(server);
+registerCreate(server);
+registerStart(server);
+registerStop(server);
+registerRestart(server);
+registerKill(server);
+registerRm(server);
+registerPause(server);
+registerUnpause(server);
+registerExec(server);
+registerPull(server);
+registerPush(server);
+registerBuild(server);
+registerTag(server);
+registerRmi(server);
+registerCommit(server);
+registerSave(server);
+registerLoad(server);
+registerComposeUp(server);
+registerComposeDown(server);
+registerComposePs(server);
+registerComposeLogs(server);
+registerComposeBuild(server);
+registerComposeRestart(server);
+registerComposePull(server);
+registerComposeExec(server);
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools/build.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=build.d.ts.map

package/dist/tools/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/tools/build.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4CzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6DhD"}

package/dist/tools/build.js

@@ -0,0 +1,90 @@
+import { z } from "zod";
+import { execDocker, errorResponse } from "../utils/docker-api.js";
+const inputSchema = {
+    context: z
+        .string()
+        .min(1)
+        .describe("Build context path (e.g. '.', './app', absolute path)"),
+    tag: z
+        .array(z.string())
+        .optional()
+        .describe("Name and optionally tag the image (e.g. ['myapp:latest', 'myapp:v1.0'])"),
+    file: z
+        .string()
+        .optional()
+        .describe("Path to Dockerfile (default: 'context/Dockerfile')"),
+    buildArgs: z
+        .array(z.string())
+        .optional()
+        .describe("Build-time variables as 'KEY=VALUE' (e.g. ['NODE_ENV=production'])"),
+    target: z
+        .string()
+        .optional()
+        .describe("Set the target build stage for multi-stage builds"),
+    noCache: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Do not use cache when building the image"),
+    pull: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Always pull a newer version of the base image"),
+    labels: z
+        .array(z.string())
+        .optional()
+        .describe("Image labels as 'key=value'"),
+    platform: z
+        .string()
+        .optional()
+        .describe("Target platform (e.g. 'linux/amd64')"),
+};
+export function register(server) {
+    server.tool("docker_build", "Build a Docker image from a Dockerfile and context directory", inputSchema, async (args) => {
+        try {
+            const cmdArgs = ["build"];
+            if (args.tag) {
+                for (const t of args.tag) {
+                    cmdArgs.push("-t", t);
+                }
+            }
+            if (args.file) {
+                cmdArgs.push("-f", args.file);
+            }
+            if (args.buildArgs) {
+                for (const ba of args.buildArgs) {
+                    cmdArgs.push("--build-arg", ba);
+                }
+            }
+            if (args.target) {
+                cmdArgs.push("--target", args.target);
+            }
+            if (args.noCache) {
+                cmdArgs.push("--no-cache");
+            }
+            if (args.pull) {
+                cmdArgs.push("--pull");
+            }
+            if (args.labels) {
+                for (const l of args.labels) {
+                    cmdArgs.push("--label", l);
+                }
+            }
+            if (args.platform) {
+                cmdArgs.push("--platform", args.platform);
+            }
+            cmdArgs.push(args.context);
+            const output = await execDocker(cmdArgs, { timeout: 600_000 });
+            return {
+                content: [
+                    { type: "text", text: output.trim() },
+                ],
+            };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=build.js.map

package/dist/tools/build.js.map

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

package/dist/tools/commit.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=commit.d.ts.map

package/dist/tools/commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.d.ts","sourceRoot":"","sources":["../../src/tools/commit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA+BzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8ChD"}

package/dist/tools/commit.js

@@ -0,0 +1,66 @@
+import { z } from "zod";
+import { execDocker, errorResponse } from "../utils/docker-api.js";
+const inputSchema = {
+    containerId: z
+        .string()
+        .min(1)
+        .describe("Container name or ID to commit"),
+    repository: z
+        .string()
+        .optional()
+        .describe("Repository name for the new image (e.g. 'myapp')"),
+    tag: z
+        .string()
+        .optional()
+        .describe("Tag for the new image (e.g. 'v1.0')"),
+    message: z
+        .string()
+        .optional()
+        .describe("Commit message"),
+    author: z
+        .string()
+        .optional()
+        .describe("Author (e.g. 'Name <email>')"),
+    pause: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe("Pause container during commit (default: true)"),
+};
+export function register(server) {
+    server.tool("docker_commit", "Create a new image from a container's changes", inputSchema, async (args) => {
+        try {
+            const cmdArgs = ["commit"];
+            if (args.message) {
+                cmdArgs.push("-m", args.message);
+            }
+            if (args.author) {
+                cmdArgs.push("-a", args.author);
+            }
+            if (!args.pause) {
+                cmdArgs.push("--pause=false");
+            }
+            cmdArgs.push(args.containerId);
+            if (args.repository) {
+                const target = args.tag
+                    ? `${args.repository}:${args.tag}`
+                    : args.repository;
+                cmdArgs.push(target);
+            }
+            const output = await execDocker(cmdArgs);
+            const imageId = output.trim();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Image created: ${imageId}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=commit.js.map

package/dist/tools/commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.js","sourceRoot":"","sources":["../../src/tools/commit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEnE,MAAM,WAAW,GAAG;IAClB,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,gCAAgC,CAAC;IAC7C,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,qCAAqC,CAAC;IAClD,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,gBAAgB,CAAC;IAC7B,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8BAA8B,CAAC;IAC3C,KAAK,EAAE,CAAC;SACL,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,+CAA+C,CAAC;CAC7D,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,eAAe,EACf,+CAA+C,EAC/C,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC;YAE3B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC;YAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAClC,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBAChB,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAChC,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAE/B,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG;oBACrB,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,EAAE;oBAClC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;YACzC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;YAE9B,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,kBAAkB,OAAO,EAAE;qBAClC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/composeBuild.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=composeBuild.d.ts.map

package/dist/tools/composeBuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composeBuild.d.ts","sourceRoot":"","sources":["../../src/tools/composeBuild.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4BzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2ChD"}

package/dist/tools/composeBuild.js

@@ -0,0 +1,59 @@
+import { z } from "zod";
+import { execDocker, errorResponse } from "../utils/docker-api.js";
+const inputSchema = {
+    file: z
+        .string()
+        .optional()
+        .describe("Path to compose file"),
+    projectDir: z
+        .string()
+        .optional()
+        .describe("Working directory for the compose project"),
+    services: z
+        .array(z.string())
+        .optional()
+        .describe("Specific services to build (default: all with build config)"),
+    noCache: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Do not use cache when building images"),
+    pull: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Always pull a newer version of base images"),
+};
+export function register(server) {
+    server.tool("docker_composeBuild", "Build or rebuild Docker Compose service images", inputSchema, async (args) => {
+        try {
+            const cmdArgs = ["compose"];
+            if (args.file) {
+                cmdArgs.push("-f", args.file);
+            }
+            if (args.projectDir) {
+                cmdArgs.push("--project-directory", args.projectDir);
+            }
+            cmdArgs.push("build");
+            if (args.noCache) {
+                cmdArgs.push("--no-cache");
+            }
+            if (args.pull) {
+                cmdArgs.push("--pull");
+            }
+            if (args.services) {
+                cmdArgs.push(...args.services);
+            }
+            const output = await execDocker(cmdArgs, { timeout: 300_000 });
+            return {
+                content: [
+                    { type: "text", text: output.trim() || "Compose images built" },
+                ],
+            };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=composeBuild.js.map

package/dist/tools/composeBuild.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composeBuild.js","sourceRoot":"","sources":["../../src/tools/composeBuild.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEnE,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sBAAsB,CAAC;IACnC,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2CAA2C,CAAC;IACxD,QAAQ,EAAE,CAAC;SACR,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,6DAA6D,CAAC;IAC1E,OAAO,EAAE,CAAC;SACP,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,uCAAuC,CAAC;IACpD,IAAI,EAAE,CAAC;SACJ,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,4CAA4C,CAAC;CAC1D,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,gDAAgD,EAChD,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC;YAE5B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAChC,CAAC;YAED,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YACvD,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAEtB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC7B,CAAC;YAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACzB,CAAC;YAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;YACjC,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YAE/D,OAAO;gBACL,OAAO,EAAE;oBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,sBAAsB,EAAE;iBACzE;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/composeDown.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=composeDown.d.ts.map

package/dist/tools/composeDown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composeDown.d.ts","sourceRoot":"","sources":["../../src/tools/composeDown.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA2BzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2ChD"}

package/dist/tools/composeDown.js

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import { execDocker, errorResponse } from "../utils/docker-api.js";
+const inputSchema = {
+    file: z
+        .string()
+        .optional()
+        .describe("Path to compose file"),
+    projectDir: z
+        .string()
+        .optional()
+        .describe("Working directory for the compose project"),
+    removeVolumes: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Remove named volumes declared in the volumes section"),
+    removeImages: z
+        .string()
+        .optional()
+        .describe("Remove images: 'all' or 'local' (built without a custom tag)"),
+    timeout: z
+        .number()
+        .optional()
+        .describe("Shutdown timeout in seconds (default: 10)"),
+};
+export function register(server) {
+    server.tool("docker_composeDown", "Stop and remove Compose containers, networks, and optionally volumes/images", inputSchema, async (args) => {
+        try {
+            const cmdArgs = ["compose"];
+            if (args.file) {
+                cmdArgs.push("-f", args.file);
+            }
+            if (args.projectDir) {
+                cmdArgs.push("--project-directory", args.projectDir);
+            }
+            cmdArgs.push("down");
+            if (args.removeVolumes) {
+                cmdArgs.push("--volumes");
+            }
+            if (args.removeImages) {
+                cmdArgs.push("--rmi", args.removeImages);
+            }
+            if (args.timeout !== undefined) {
+                cmdArgs.push("--timeout", String(args.timeout));
+            }
+            const output = await execDocker(cmdArgs, { timeout: 120_000 });
+            return {
+                content: [
+                    { type: "text", text: output.trim() || "Compose services stopped and removed" },
+                ],
+            };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=composeDown.js.map

package/dist/tools/composeDown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composeDown.js","sourceRoot":"","sources":["../../src/tools/composeDown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEnE,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sBAAsB,CAAC;IACnC,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2CAA2C,CAAC;IACxD,aAAa,EAAE,CAAC;SACb,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,sDAAsD,CAAC;IACnE,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8DAA8D,CAAC;IAC3E,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2CAA2C,CAAC;CACzD,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,6EAA6E,EAC7E,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC;YAE5B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAChC,CAAC;YAED,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YACvD,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAErB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACvB,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC5B,CAAC;YAED,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;YAC3C,CAAC;YAED,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC/B,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;YAClD,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YAE/D,OAAO;gBACL,OAAO,EAAE;oBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,sCAAsC,EAAE;iBACzF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/composeExec.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=composeExec.d.ts.map

package/dist/tools/composeExec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composeExec.d.ts","sourceRoot":"","sources":["../../src/tools/composeExec.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkCzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+ChD"}

package/dist/tools/composeExec.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+import { execDocker, errorResponse } from "../utils/docker-api.js";
+const inputSchema = {
+    file: z
+        .string()
+        .optional()
+        .describe("Path to compose file"),
+    projectDir: z
+        .string()
+        .optional()
+        .describe("Working directory for the compose project"),
+    service: z
+        .string()
+        .min(1)
+        .describe("Service name to execute the command in"),
+    command: z
+        .array(z.string())
+        .min(1)
+        .describe("Command and arguments to execute (e.g. ['sh', '-c', 'echo hello'])"),
+    user: z
+        .string()
+        .optional()
+        .describe("Run as this user (e.g. 'root', '1000')"),
+    workdir: z
+        .string()
+        .optional()
+        .describe("Working directory inside the container"),
+    env: z
+        .array(z.string())
+        .optional()
+        .describe("Environment variables as 'KEY=VALUE'"),
+};
+export function register(server) {
+    server.tool("docker_composeExec", "Execute a command in a running Docker Compose service container", inputSchema, async (args) => {
+        try {
+            const cmdArgs = ["compose"];
+            if (args.file) {
+                cmdArgs.push("-f", args.file);
+            }
+            if (args.projectDir) {
+                cmdArgs.push("--project-directory", args.projectDir);
+            }
+            cmdArgs.push("exec", "-T");
+            if (args.user) {
+                cmdArgs.push("--user", args.user);
+            }
+            if (args.workdir) {
+                cmdArgs.push("--workdir", args.workdir);
+            }
+            if (args.env) {
+                for (const e of args.env) {
+                    cmdArgs.push("-e", e);
+                }
+            }
+            cmdArgs.push(args.service, ...args.command);
+            const output = await execDocker(cmdArgs);
+            return {
+                content: [
+                    { type: "text", text: output.trim() },
+                ],
+            };
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=composeExec.js.map