@supernova123/docker-mcp-server 0.1.4 → 0.1.6

package/.dockerignore

@@ -0,0 +1,9 @@
+node_modules
+dist
+.git
+*.md
+!README.md
+tests
+tsconfig.json
+vitest.config.ts
+.DS_Store

package/Dockerfile

@@ -0,0 +1,29 @@
+FROM node:22-slim AS builder
+
+WORKDIR /app
+
+# Copy package files first for better layer caching
+COPY package.json package-lock.json ./
+RUN npm ci --ignore-scripts
+
+# Copy source and build
+COPY tsconfig.json ./
+COPY src/ ./src/
+RUN npm run build
+
+# Production stage
+FROM node:22-slim
+
+WORKDIR /app
+
+# Copy package files and install production deps only
+COPY package.json package-lock.json ./
+RUN npm ci --omit=dev --ignore-scripts
+
+# Copy built output
+COPY --from=builder /app/dist/ ./dist/
+
+# The server communicates via stdio (MCP transport)
+# No EXPOSE needed — stdio transport doesn't listen on a port
+
+ENTRYPOINT ["node", "dist/index.js"]

package/dist/tools/container.js

@@ -45,6 +45,10 @@ export function registerContainerTools(server, docker) {
             return { content: [{ type: "text", text: `Container ${params.container_id} stopped.` }] };
         }
         catch (error) {
+            // 304 means container is already stopped — treat as success
+            if (error?.statusCode === 304) {
+                return { content: [{ type: "text", text: `Container ${params.container_id} was already stopped.` }] };
+            }
             return { content: [{ type: "text", text: `Error: ${formatError(error)}` }], isError: true };
         }
     });
@@ -103,7 +107,7 @@ export function registerContainerTools(server, docker) {
             return { content: [{ type: "text", text: `Error: ${formatError(error)}` }], isError: true };
         }
     });
-    server.tool("run_container", "Create and start a new Docker container with one command. Supports image, env, ports, volumes, restart policy, and command override.", RunContainerSchema.shape, async (params) => {
+    server.tool("run_container", "Create and start a new Docker container with one command. Supports image, env, ports, volumes, restart policy, and command override. Auto-pulls missing images.", RunContainerSchema.shape, async (params) => {
         try {
             const createOpts = {
                 Image: params.image,
@@ -126,7 +130,28 @@ export function registerContainerTools(server, docker) {
                         : undefined,
                 },
             };
-            const container = await docker.createContainer(createOpts);
+            let container;
+            try {
+                container = await docker.createContainer(createOpts);
+            }
+            catch (createError) {
+                // Auto-pull if image not found (HTTP 404)
+                if (createError?.statusCode === 404 && /no such image|No such image/i.test(createError.message || "")) {
+                    const stream = await docker.pull(params.image);
+                    await new Promise((resolve, reject) => {
+                        docker.modem.followProgress(stream, (err) => {
+                            if (err)
+                                reject(err);
+                            else
+                                resolve();
+                        });
+                    });
+                    container = await docker.createContainer(createOpts);
+                }
+                else {
+                    throw createError;
+                }
+            }
             await container.start();
             return {
                 content: [{ type: "text", text: `Container created and started. ID: ${container.id.substring(0, 12)}` }],

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@supernova123/docker-mcp-server",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "mcpName": "io.github.friendlygeorge/docker-mcp-server",
-  "description": "MCP server for Docker \u2014 container management, health checks, auto-restart, Compose lifecycle, and log streaming for Claude, Cursor, and AI agents",
+  "description": "MCP server for Docker — container management, health checks, auto-restart, Compose lifecycle, and log streaming for Claude, Cursor, and AI agents",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -17,20 +17,20 @@
   },
   "keywords": [
     "mcp",
+    "mcp-server",
     "docker",
+    "docker-mcp",
     "container",
     "compose",
     "health-check",
     "devops",
     "ai-agent",
     "model-context-protocol",
-    "mcp-server",
-    "modelcontextprotocol",
     "claude",
     "cursor",
     "chatgpt",
-    "docker-mcp",
-    "mcp-docker"
+    "claude-desktop",
+    "ai"
   ],
   "author": "Nova",
   "license": "MIT",
@@ -53,4 +53,4 @@
     "typescript": "^5.7.0",
     "vitest": "^3.1.0"
   }
-}
+}

package/src/tools/container.ts

@@ -74,7 +74,11 @@ export function registerContainerTools(server: McpServer, docker: Dockerode): vo
         const container = docker.getContainer(params.container_id);
         await container.stop({ t: params.timeout ?? 10 });
         return { content: [{ type: "text", text: `Container ${params.container_id} stopped.` }] };
-      } catch (error) {
+      } catch (error: any) {
+        // 304 means container is already stopped — treat as success
+        if (error?.statusCode === 304) {
+          return { content: [{ type: "text", text: `Container ${params.container_id} was already stopped.` }] };
+        }
         return { content: [{ type: "text", text: `Error: ${formatError(error)}` }], isError: true };
       }
     }
@@ -152,7 +156,7 @@ export function registerContainerTools(server: McpServer, docker: Dockerode): vo
 
   server.tool(
     "run_container",
-    "Create and start a new Docker container with one command. Supports image, env, ports, volumes, restart policy, and command override.",
+    "Create and start a new Docker container with one command. Supports image, env, ports, volumes, restart policy, and command override. Auto-pulls missing images.",
     RunContainerSchema.shape,
     async (params) => {
       try {
@@ -180,7 +184,25 @@ export function registerContainerTools(server: McpServer, docker: Dockerode): vo
           },
         };
 
-        const container = await docker.createContainer(createOpts);
+        let container;
+        try {
+          container = await docker.createContainer(createOpts);
+        } catch (createError: any) {
+          // Auto-pull if image not found (HTTP 404)
+          if (createError?.statusCode === 404 && /no such image|No such image/i.test(createError.message || "")) {
+            const stream = await docker.pull(params.image);
+            await new Promise<void>((resolve, reject) => {
+              docker.modem.followProgress(stream, (err: Error | null) => {
+                if (err) reject(err);
+                else resolve();
+              });
+            });
+            container = await docker.createContainer(createOpts);
+          } else {
+            throw createError;
+          }
+        }
+
         await container.start();
         return {
           content: [{ type: "text", text: `Container created and started. ID: ${container.id.substring(0, 12)}` }],