@supernova123/docker-mcp-server 0.1.3 → 0.1.5

package/dist/tools/compose.js

@@ -1,11 +1,32 @@
 import { execSync, exec as execCb } from "child_process";
+import { existsSync, statSync } from "fs";
+import { join } from "path";
 import { promisify } from "util";
 import { ComposeUpSchema, ComposeDownSchema, ComposePsSchema, ComposeLogsSchema, ComposeRestartSchema, } from "../types.js";
 import { formatError } from "../docker.js";
 const execAsync = promisify(execCb);
+const COMPOSE_FILE_NAMES = ["docker-compose.yml", "docker-compose.yaml", "compose.yml", "compose.yaml"];
+function resolveComposePath(inputPath) {
+    // If it's already a file that exists, use it directly
+    if (existsSync(inputPath) && statSync(inputPath).isFile()) {
+        return inputPath;
+    }
+    // If it's a directory, look for compose files inside it
+    if (existsSync(inputPath) && statSync(inputPath).isDirectory()) {
+        for (const name of COMPOSE_FILE_NAMES) {
+            const filePath = join(inputPath, name);
+            if (existsSync(filePath))
+                return filePath;
+        }
+        throw new Error(`No docker-compose.yml found in ${inputPath}. Looked for: ${COMPOSE_FILE_NAMES.join(", ")}`);
+    }
+    // Path doesn't exist — pass it through and let Docker produce the error
+    return inputPath;
+}
 function runCompose(path, args) {
+    const filePath = resolveComposePath(path);
     try {
-        const result = execSync(`docker compose -f ${path} ${args.join(" ")}`, {
+        const result = execSync(`docker compose -f "${filePath}" ${args.join(" ")}`, {
             encoding: "utf-8",
             timeout: 30000,
         });

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 };
         }
     });

package/dist/types.js

@@ -60,18 +60,18 @@ export const RemoveImageSchema = z.object({
 });
 // Docker Compose schemas
 export const ComposeUpSchema = z.object({
-    path: z.string().describe("Path to docker-compose.yml directory"),
+    path: z.string().describe("Path to docker-compose.yml file or its parent directory"),
     build: z.boolean().optional().describe("Build images before starting (default: false)"),
     detach: z.boolean().optional().describe("Run in detached mode (default: true)"),
     services: z.array(z.string()).optional().describe("Specific services to start"),
 });
 export const ComposeDownSchema = z.object({
-    path: z.string().describe("Path to docker-compose.yml directory"),
+    path: z.string().describe("Path to docker-compose.yml file or its parent directory"),
     volumes: z.boolean().optional().describe("Remove named volumes (default: false)"),
     timeout: z.number().optional().describe("Shutdown timeout in seconds (default: 10)"),
 });
 export const ComposePsSchema = z.object({
-    path: z.string().describe("Path to docker-compose.yml directory"),
+    path: z.string().describe("Path to docker-compose.yml file or its parent directory"),
 });
 export const ComposeLogsSchema = z.object({
     path: z.string().describe("Path to docker-compose.yml directory"),
@@ -80,7 +80,7 @@ export const ComposeLogsSchema = z.object({
     follow: z.boolean().optional().describe("Follow log output (default: false)"),
 });
 export const ComposeRestartSchema = z.object({
-    path: z.string().describe("Path to docker-compose.yml directory"),
+    path: z.string().describe("Path to docker-compose.yml file or its parent directory"),
     services: z.array(z.string()).optional().describe("Specific services to restart (empty = all)"),
     timeout: z.number().optional().describe("Shutdown timeout in seconds (default: 10)"),
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supernova123/docker-mcp-server",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "mcpName": "io.github.friendlygeorge/docker-mcp-server",
   "description": "MCP server for Docker — container management, health checks, auto-restart, Compose lifecycle, and log streaming for Claude, Cursor, and AI agents",
   "type": "module",
@@ -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",

package/server.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.friendlygeorge/docker-mcp-server",
+  "description": "MCP server for Docker — containers, health checks, Compose, logs for AI agents",
+  "repository": {
+    "url": "https://github.com/friendlygeorge/docker-mcp-server",
+    "source": "github"
+  },
+  "version": "0.1.3",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@supernova123/docker-mcp-server",
+      "version": "0.1.3",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "description": "Docker socket path (default: /var/run/docker.sock)",
+          "isRequired": false,
+          "format": "string",
+          "name": "DOCKER_HOST"
+        }
+      ]
+    }
+  ]
+}

package/src/tools/compose.ts

@@ -1,4 +1,6 @@
 import { execSync, exec as execCb } from "child_process";
+import { existsSync, statSync } from "fs";
+import { join } from "path";
 import { promisify } from "util";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import {
@@ -12,9 +14,29 @@ import { formatError } from "../docker.js";
 
 const execAsync = promisify(execCb);
 
+const COMPOSE_FILE_NAMES = ["docker-compose.yml", "docker-compose.yaml", "compose.yml", "compose.yaml"];
+
+function resolveComposePath(inputPath: string): string {
+  // If it's already a file that exists, use it directly
+  if (existsSync(inputPath) && statSync(inputPath).isFile()) {
+    return inputPath;
+  }
+  // If it's a directory, look for compose files inside it
+  if (existsSync(inputPath) && statSync(inputPath).isDirectory()) {
+    for (const name of COMPOSE_FILE_NAMES) {
+      const filePath = join(inputPath, name);
+      if (existsSync(filePath)) return filePath;
+    }
+    throw new Error(`No docker-compose.yml found in ${inputPath}. Looked for: ${COMPOSE_FILE_NAMES.join(", ")}`);
+  }
+  // Path doesn't exist — pass it through and let Docker produce the error
+  return inputPath;
+}
+
 function runCompose(path: string, args: string[]): string {
+  const filePath = resolveComposePath(path);
   try {
-    const result = execSync(`docker compose -f ${path} ${args.join(" ")}`, {
+    const result = execSync(`docker compose -f "${filePath}" ${args.join(" ")}`, {
       encoding: "utf-8",
       timeout: 30000,
     });

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 };
       }
     }

package/src/types.ts

@@ -73,20 +73,20 @@ export const RemoveImageSchema = z.object({
 
 // Docker Compose schemas
 export const ComposeUpSchema = z.object({
-  path: z.string().describe("Path to docker-compose.yml directory"),
+  path: z.string().describe("Path to docker-compose.yml file or its parent directory"),
   build: z.boolean().optional().describe("Build images before starting (default: false)"),
   detach: z.boolean().optional().describe("Run in detached mode (default: true)"),
   services: z.array(z.string()).optional().describe("Specific services to start"),
 });
 
 export const ComposeDownSchema = z.object({
-  path: z.string().describe("Path to docker-compose.yml directory"),
+  path: z.string().describe("Path to docker-compose.yml file or its parent directory"),
   volumes: z.boolean().optional().describe("Remove named volumes (default: false)"),
   timeout: z.number().optional().describe("Shutdown timeout in seconds (default: 10)"),
 });
 
 export const ComposePsSchema = z.object({
-  path: z.string().describe("Path to docker-compose.yml directory"),
+  path: z.string().describe("Path to docker-compose.yml file or its parent directory"),
 });
 
 export const ComposeLogsSchema = z.object({
@@ -97,7 +97,7 @@ export const ComposeLogsSchema = z.object({
 });
 
 export const ComposeRestartSchema = z.object({
-  path: z.string().describe("Path to docker-compose.yml directory"),
+  path: z.string().describe("Path to docker-compose.yml file or its parent directory"),
   services: z.array(z.string()).optional().describe("Specific services to restart (empty = all)"),
   timeout: z.number().optional().describe("Shutdown timeout in seconds (default: 10)"),
 });