mcp-docker-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ofer Shapira
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,124 @@
+# mcp-server-docker
+
+[![npm version](https://img.shields.io/npm/v/mcp-docker-server.svg)](https://www.npmjs.com/package/mcp-docker-server)
+[![npm downloads](https://img.shields.io/npm/dm/mcp-docker-server.svg)](https://www.npmjs.com/package/mcp-docker-server)
+[![CI](https://github.com/ofershap/mcp-server-docker/actions/workflows/ci.yml/badge.svg)](https://github.com/ofershap/mcp-server-docker/actions/workflows/ci.yml)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue.svg)](https://www.typescriptlang.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Control Docker containers, images, and services from your AI coding assistant. List, start, stop, read logs, run commands inside containers, and check resource usage.
+
+```bash
+npx mcp-docker-server
+```
+
+> Compatible with Claude Desktop, Cursor, VS Code Copilot, and any MCP-compatible client. No API keys needed. Connects to your local Docker socket automatically.
+
+![MCP server for Docker containers, logs, and resource monitoring](assets/demo.gif)
+
+<sub>Demo built with <a href="https://github.com/ofershap/remotion-readme-kit">remotion-readme-kit</a></sub>
+
+## Why
+
+If you work with Docker daily, you know the routine: switch to a terminal, type `docker ps`, scroll through logs, copy container IDs, restart services. It adds up. This MCP server lets your AI assistant handle those tasks for you while you stay focused on code. Ask it to check which containers are running, pull up logs from a failing service, or restart something that got stuck. It talks to Docker's API through the local socket, so there's nothing to configure and no credentials to manage.
+
+## Tools
+
+| Tool                | What it does                                                        |
+| ------------------- | ------------------------------------------------------------------- |
+| `list_containers`   | List running (or all) containers with status, ports, and image info |
+| `container_logs`    | Get recent logs from a container                                    |
+| `start_container`   | Start a stopped container                                           |
+| `stop_container`    | Stop a running container                                            |
+| `restart_container` | Restart a container                                                 |
+| `remove_container`  | Remove a container (with optional force)                            |
+| `exec_command`      | Execute a command inside a running container                        |
+| `container_stats`   | Get live CPU, memory, and network stats                             |
+| `list_images`       | List all Docker images on the host                                  |
+| `remove_image`      | Remove a Docker image                                               |
+
+## Quick Start
+
+### Cursor
+
+Add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "docker": {
+      "command": "npx",
+      "args": ["-y", "mcp-docker-server"]
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "docker": {
+      "command": "npx",
+      "args": ["-y", "mcp-docker-server"]
+    }
+  }
+}
+```
+
+### VS Code
+
+Add to user settings or `.vscode/mcp.json`:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "docker": {
+        "command": "npx",
+        "args": ["-y", "mcp-docker-server"]
+      }
+    }
+  }
+}
+```
+
+## Examples
+
+- "List all running Docker containers"
+- "Show me the logs from the nginx container"
+- "Restart the api-server container"
+- "What's the CPU and memory usage of my postgres container?"
+- "Execute `ls -la /app` inside the web container"
+- "List all Docker images and their sizes"
+- "Stop all containers that are using the old image"
+
+## Prerequisites
+
+- **Docker** must be running on your machine
+- The server connects to the Docker socket at `/var/run/docker.sock` (Linux/macOS) or the named pipe on Windows
+- No API keys or tokens required
+
+## Development
+
+```bash
+git clone https://github.com/ofershap/mcp-server-docker.git
+cd mcp-server-docker
+npm install
+npm test
+npm run build
+```
+
+## Author
+
+**Ofer Shapira**
+
+[![LinkedIn](https://img.shields.io/badge/LinkedIn-ofershap-blue?logo=linkedin)](https://linkedin.com/in/ofershap)
+[![GitHub](https://img.shields.io/badge/GitHub-ofershap-black?logo=github)](https://github.com/ofershap)
+
+## License
+
+MIT © 2026 Ofer Shapira

package/dist/index.js

@@ -0,0 +1,273 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+// src/docker.ts
+import Dockerode from "dockerode";
+var docker = new Dockerode();
+function formatBytes(bytes) {
+  if (bytes === 0) return "0 B";
+  const k = 1024;
+  const sizes = ["B", "KB", "MB", "GB"];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return `${(bytes / Math.pow(k, i)).toFixed(1)} ${sizes[i]}`;
+}
+function formatPorts(ports) {
+  return ports.map((p) => {
+    if (p.PublicPort) return `${p.PublicPort}->${p.PrivatePort}/${p.Type}`;
+    return `${p.PrivatePort}/${p.Type}`;
+  }).join(", ");
+}
+async function listContainers(all) {
+  const containers = await docker.listContainers({ all });
+  return containers.map((c) => ({
+    id: c.Id.slice(0, 12),
+    name: c.Names[0]?.replace(/^\//, "") ?? "",
+    image: c.Image,
+    state: c.State,
+    status: c.Status,
+    ports: formatPorts(c.Ports),
+    created: new Date(c.Created * 1e3).toISOString()
+  }));
+}
+async function containerLogs(id, tail) {
+  const container = docker.getContainer(id);
+  const logs = await container.logs({
+    stdout: true,
+    stderr: true,
+    tail,
+    follow: false
+  });
+  return logs.toString("utf-8").replace(/[\x00-\x08]/g, "");
+}
+async function startContainer(id) {
+  const container = docker.getContainer(id);
+  await container.start();
+  return `Container ${id} started`;
+}
+async function stopContainer(id) {
+  const container = docker.getContainer(id);
+  await container.stop();
+  return `Container ${id} stopped`;
+}
+async function restartContainer(id) {
+  const container = docker.getContainer(id);
+  await container.restart();
+  return `Container ${id} restarted`;
+}
+async function removeContainer(id, force) {
+  const container = docker.getContainer(id);
+  await container.remove({ force });
+  return `Container ${id} removed`;
+}
+async function execCommand(id, command) {
+  const container = docker.getContainer(id);
+  const exec = await container.exec({
+    Cmd: command,
+    AttachStdout: true,
+    AttachStderr: true
+  });
+  const stream = await exec.start({ hijack: true, stdin: false });
+  return new Promise((resolve) => {
+    const chunks = [];
+    stream.on("data", (chunk) => chunks.push(chunk));
+    stream.on("end", () => {
+      resolve(
+        Buffer.concat(chunks).toString("utf-8").replace(/[\x00-\x08]/g, "")
+        // eslint-disable-line no-control-regex
+      );
+    });
+  });
+}
+async function containerStats(id) {
+  const container = docker.getContainer(id);
+  const stats = await container.stats({
+    stream: false
+  });
+  const cpuStats = stats.cpu_stats;
+  const precpuStats = stats.precpu_stats;
+  const cpuDelta = cpuStats.cpu_usage.total_usage - precpuStats.cpu_usage.total_usage;
+  const systemDelta = cpuStats.system_cpu_usage - precpuStats.system_cpu_usage;
+  const cpuCount = cpuStats.cpu_usage.percpu_usage?.length ?? 1;
+  const cpuPercent = systemDelta > 0 ? (cpuDelta / systemDelta * cpuCount * 100).toFixed(2) : "0.00";
+  const memUsage = stats.memory_stats.usage ?? 0;
+  const memLimit = stats.memory_stats.limit ?? 0;
+  const memPercent = memLimit > 0 ? (memUsage / memLimit * 100).toFixed(2) : "0.00";
+  const networks = stats.networks ?? {};
+  let rxBytes = 0;
+  let txBytes = 0;
+  for (const iface of Object.values(networks)) {
+    rxBytes += iface.rx_bytes ?? 0;
+    txBytes += iface.tx_bytes ?? 0;
+  }
+  return {
+    cpu_percent: `${cpuPercent}%`,
+    memory_usage: formatBytes(memUsage),
+    memory_limit: formatBytes(memLimit),
+    memory_percent: `${memPercent}%`,
+    network_rx: formatBytes(rxBytes),
+    network_tx: formatBytes(txBytes)
+  };
+}
+async function listImages() {
+  const images = await docker.listImages();
+  return images.map((img) => ({
+    id: img.Id.replace("sha256:", "").slice(0, 12),
+    tags: img.RepoTags ?? ["<none>"],
+    size: formatBytes(img.Size),
+    created: new Date(img.Created * 1e3).toISOString()
+  }));
+}
+async function removeImage(id, force) {
+  const image = docker.getImage(id);
+  await image.remove({ force });
+  return `Image ${id} removed`;
+}
+
+// src/index.ts
+var server = new McpServer({
+  name: "mcp-server-docker",
+  version: "1.0.0"
+});
+server.tool(
+  "list_containers",
+  "List Docker containers. Set all=true to include stopped containers.",
+  {
+    all: z.boolean().optional().default(false).describe("Include stopped containers")
+  },
+  async ({ all }) => {
+    const containers = await listContainers(all);
+    return {
+      content: [
+        {
+          type: "text",
+          text: containers.length === 0 ? "No containers found." : containers.map(
+            (c) => `${c.id}  ${c.name.padEnd(30)}  ${c.image.padEnd(30)}  ${c.state.padEnd(10)}  ${c.status}`
+          ).join("\n")
+        }
+      ]
+    };
+  }
+);
+server.tool(
+  "container_logs",
+  "Get logs from a Docker container.",
+  {
+    id: z.string().describe("Container ID or name"),
+    tail: z.number().optional().default(100).describe("Number of lines from the end")
+  },
+  async ({ id, tail }) => {
+    const logs = await containerLogs(id, tail);
+    return { content: [{ type: "text", text: logs || "(no logs)" }] };
+  }
+);
+server.tool(
+  "start_container",
+  "Start a stopped Docker container.",
+  { id: z.string().describe("Container ID or name") },
+  async ({ id }) => {
+    const result = await startContainer(id);
+    return { content: [{ type: "text", text: result }] };
+  }
+);
+server.tool(
+  "stop_container",
+  "Stop a running Docker container.",
+  { id: z.string().describe("Container ID or name") },
+  async ({ id }) => {
+    const result = await stopContainer(id);
+    return { content: [{ type: "text", text: result }] };
+  }
+);
+server.tool(
+  "restart_container",
+  "Restart a Docker container.",
+  { id: z.string().describe("Container ID or name") },
+  async ({ id }) => {
+    const result = await restartContainer(id);
+    return { content: [{ type: "text", text: result }] };
+  }
+);
+server.tool(
+  "remove_container",
+  "Remove a Docker container. Use force=true to remove running containers.",
+  {
+    id: z.string().describe("Container ID or name"),
+    force: z.boolean().optional().default(false).describe("Force remove running container")
+  },
+  async ({ id, force }) => {
+    const result = await removeContainer(id, force);
+    return { content: [{ type: "text", text: result }] };
+  }
+);
+server.tool(
+  "exec_command",
+  "Execute a command inside a running Docker container.",
+  {
+    id: z.string().describe("Container ID or name"),
+    command: z.array(z.string()).describe("Command and arguments, e.g. ['ls', '-la']")
+  },
+  async ({ id, command }) => {
+    const output = await execCommand(id, command);
+    return {
+      content: [{ type: "text", text: output || "(no output)" }]
+    };
+  }
+);
+server.tool(
+  "container_stats",
+  "Get CPU, memory, and network stats for a running Docker container.",
+  { id: z.string().describe("Container ID or name") },
+  async ({ id }) => {
+    const stats = await containerStats(id);
+    return {
+      content: [
+        {
+          type: "text",
+          text: [
+            `CPU:     ${stats.cpu_percent}`,
+            `Memory:  ${stats.memory_usage} / ${stats.memory_limit} (${stats.memory_percent})`,
+            `Network: \u2193 ${stats.network_rx}  \u2191 ${stats.network_tx}`
+          ].join("\n")
+        }
+      ]
+    };
+  }
+);
+server.tool("list_images", "List Docker images on the host.", {}, async () => {
+  const images = await listImages();
+  return {
+    content: [
+      {
+        type: "text",
+        text: images.length === 0 ? "No images found." : images.map(
+          (img) => `${img.id}  ${img.tags.join(", ").padEnd(40)}  ${img.size.padEnd(10)}  ${img.created}`
+        ).join("\n")
+      }
+    ]
+  };
+});
+server.tool(
+  "remove_image",
+  "Remove a Docker image. Use force=true to force removal.",
+  {
+    id: z.string().describe("Image ID or tag"),
+    force: z.boolean().optional().default(false).describe("Force remove")
+  },
+  async ({ id, force }) => {
+    const result = await removeImage(id, force);
+    return { content: [{ type: "text", text: result }] };
+  }
+);
+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,"sources":["../src/index.ts","../src/docker.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { z } from \"zod\";\nimport {\n  listContainers,\n  containerLogs,\n  startContainer,\n  stopContainer,\n  restartContainer,\n  removeContainer,\n  execCommand,\n  containerStats,\n  listImages,\n  removeImage,\n} from \"./docker.js\";\n\nconst server = new McpServer({\n  name: \"mcp-server-docker\",\n  version: \"1.0.0\",\n});\n\nserver.tool(\n  \"list_containers\",\n  \"List Docker containers. Set all=true to include stopped containers.\",\n  {\n    all: z\n      .boolean()\n      .optional()\n      .default(false)\n      .describe(\"Include stopped containers\"),\n  },\n  async ({ all }) => {\n    const containers = await listContainers(all);\n    return {\n      content: [\n        {\n          type: \"text\",\n          text:\n            containers.length === 0\n              ? \"No containers found.\"\n              : containers\n                  .map(\n                    (c) =>\n                      `${c.id}  ${c.name.padEnd(30)}  ${c.image.padEnd(30)}  ${c.state.padEnd(10)}  ${c.status}`,\n                  )\n                  .join(\"\\n\"),\n        },\n      ],\n    };\n  },\n);\n\nserver.tool(\n  \"container_logs\",\n  \"Get logs from a Docker container.\",\n  {\n    id: z.string().describe(\"Container ID or name\"),\n    tail: z\n      .number()\n      .optional()\n      .default(100)\n      .describe(\"Number of lines from the end\"),\n  },\n  async ({ id, tail }) => {\n    const logs = await containerLogs(id, tail);\n    return { content: [{ type: \"text\", text: logs || \"(no logs)\" }] };\n  },\n);\n\nserver.tool(\n  \"start_container\",\n  \"Start a stopped Docker container.\",\n  { id: z.string().describe(\"Container ID or name\") },\n  async ({ id }) => {\n    const result = await startContainer(id);\n    return { content: [{ type: \"text\", text: result }] };\n  },\n);\n\nserver.tool(\n  \"stop_container\",\n  \"Stop a running Docker container.\",\n  { id: z.string().describe(\"Container ID or name\") },\n  async ({ id }) => {\n    const result = await stopContainer(id);\n    return { content: [{ type: \"text\", text: result }] };\n  },\n);\n\nserver.tool(\n  \"restart_container\",\n  \"Restart a Docker container.\",\n  { id: z.string().describe(\"Container ID or name\") },\n  async ({ id }) => {\n    const result = await restartContainer(id);\n    return { content: [{ type: \"text\", text: result }] };\n  },\n);\n\nserver.tool(\n  \"remove_container\",\n  \"Remove a Docker container. Use force=true to remove running containers.\",\n  {\n    id: z.string().describe(\"Container ID or name\"),\n    force: z\n      .boolean()\n      .optional()\n      .default(false)\n      .describe(\"Force remove running container\"),\n  },\n  async ({ id, force }) => {\n    const result = await removeContainer(id, force);\n    return { content: [{ type: \"text\", text: result }] };\n  },\n);\n\nserver.tool(\n  \"exec_command\",\n  \"Execute a command inside a running Docker container.\",\n  {\n    id: z.string().describe(\"Container ID or name\"),\n    command: z\n      .array(z.string())\n      .describe(\"Command and arguments, e.g. ['ls', '-la']\"),\n  },\n  async ({ id, command }) => {\n    const output = await execCommand(id, command);\n    return {\n      content: [{ type: \"text\", text: output || \"(no output)\" }],\n    };\n  },\n);\n\nserver.tool(\n  \"container_stats\",\n  \"Get CPU, memory, and network stats for a running Docker container.\",\n  { id: z.string().describe(\"Container ID or name\") },\n  async ({ id }) => {\n    const stats = await containerStats(id);\n    return {\n      content: [\n        {\n          type: \"text\",\n          text: [\n            `CPU:     ${stats.cpu_percent}`,\n            `Memory:  ${stats.memory_usage} / ${stats.memory_limit} (${stats.memory_percent})`,\n            `Network: ↓ ${stats.network_rx}  ↑ ${stats.network_tx}`,\n          ].join(\"\\n\"),\n        },\n      ],\n    };\n  },\n);\n\nserver.tool(\"list_images\", \"List Docker images on the host.\", {}, async () => {\n  const images = await listImages();\n  return {\n    content: [\n      {\n        type: \"text\",\n        text:\n          images.length === 0\n            ? \"No images found.\"\n            : images\n                .map(\n                  (img) =>\n                    `${img.id}  ${img.tags.join(\", \").padEnd(40)}  ${img.size.padEnd(10)}  ${img.created}`,\n                )\n                .join(\"\\n\"),\n      },\n    ],\n  };\n});\n\nserver.tool(\n  \"remove_image\",\n  \"Remove a Docker image. Use force=true to force removal.\",\n  {\n    id: z.string().describe(\"Image ID or tag\"),\n    force: z.boolean().optional().default(false).describe(\"Force remove\"),\n  },\n  async ({ id, force }) => {\n    const result = await removeImage(id, force);\n    return { content: [{ type: \"text\", text: result }] };\n  },\n);\n\nasync function main() {\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n}\n\nmain().catch((error) => {\n  console.error(\"Fatal error:\", error);\n  process.exit(1);\n});\n","import Dockerode from \"dockerode\";\n\nconst docker = new Dockerode();\n\nexport interface ContainerInfo {\n  id: string;\n  name: string;\n  image: string;\n  state: string;\n  status: string;\n  ports: string;\n  created: string;\n}\n\nexport interface ContainerStats {\n  cpu_percent: string;\n  memory_usage: string;\n  memory_limit: string;\n  memory_percent: string;\n  network_rx: string;\n  network_tx: string;\n}\n\nexport interface ImageInfo {\n  id: string;\n  tags: string[];\n  size: string;\n  created: string;\n}\n\nfunction formatBytes(bytes: number): string {\n  if (bytes === 0) return \"0 B\";\n  const k = 1024;\n  const sizes = [\"B\", \"KB\", \"MB\", \"GB\"];\n  const i = Math.floor(Math.log(bytes) / Math.log(k));\n  return `${(bytes / Math.pow(k, i)).toFixed(1)} ${sizes[i]}`;\n}\n\nfunction formatPorts(ports: Dockerode.Port[]): string {\n  return ports\n    .map((p) => {\n      if (p.PublicPort) return `${p.PublicPort}->${p.PrivatePort}/${p.Type}`;\n      return `${p.PrivatePort}/${p.Type}`;\n    })\n    .join(\", \");\n}\n\nexport async function listContainers(all: boolean): Promise<ContainerInfo[]> {\n  const containers = await docker.listContainers({ all });\n  return containers.map((c) => ({\n    id: c.Id.slice(0, 12),\n    name: c.Names[0]?.replace(/^\\//, \"\") ?? \"\",\n    image: c.Image,\n    state: c.State,\n    status: c.Status,\n    ports: formatPorts(c.Ports),\n    created: new Date(c.Created * 1000).toISOString(),\n  }));\n}\n\nexport async function containerLogs(id: string, tail: number): Promise<string> {\n  const container = docker.getContainer(id);\n  const logs = await container.logs({\n    stdout: true,\n    stderr: true,\n    tail,\n    follow: false,\n  });\n  // Strip Docker log control characters (eslint: intentional for Docker output)\n  return logs.toString(\"utf-8\").replace(/[\\x00-\\x08]/g, \"\"); // eslint-disable-line no-control-regex\n}\n\nexport async function startContainer(id: string): Promise<string> {\n  const container = docker.getContainer(id);\n  await container.start();\n  return `Container ${id} started`;\n}\n\nexport async function stopContainer(id: string): Promise<string> {\n  const container = docker.getContainer(id);\n  await container.stop();\n  return `Container ${id} stopped`;\n}\n\nexport async function restartContainer(id: string): Promise<string> {\n  const container = docker.getContainer(id);\n  await container.restart();\n  return `Container ${id} restarted`;\n}\n\nexport async function removeContainer(\n  id: string,\n  force: boolean,\n): Promise<string> {\n  const container = docker.getContainer(id);\n  await container.remove({ force });\n  return `Container ${id} removed`;\n}\n\nexport async function execCommand(\n  id: string,\n  command: string[],\n): Promise<string> {\n  const container = docker.getContainer(id);\n  const exec = await container.exec({\n    Cmd: command,\n    AttachStdout: true,\n    AttachStderr: true,\n  });\n  const stream = await exec.start({ hijack: true, stdin: false });\n  return new Promise((resolve) => {\n    const chunks: Buffer[] = [];\n    stream.on(\"data\", (chunk: Buffer) => chunks.push(chunk));\n    stream.on(\"end\", () => {\n      resolve(\n        Buffer.concat(chunks)\n          .toString(\"utf-8\")\n          .replace(/[\\x00-\\x08]/g, \"\"), // eslint-disable-line no-control-regex\n      );\n    });\n  });\n}\n\ninterface CpuStats {\n  cpu_usage: { total_usage: number; percpu_usage?: number[] };\n  system_cpu_usage: number;\n}\n\ninterface MemoryStats {\n  usage?: number;\n  limit?: number;\n}\n\ntype NetworkStats = Record<string, { rx_bytes?: number; tx_bytes?: number }>;\n\nexport async function containerStats(id: string): Promise<ContainerStats> {\n  const container = docker.getContainer(id);\n  const stats = (await container.stats({\n    stream: false,\n  })) as {\n    cpu_stats: CpuStats;\n    precpu_stats: CpuStats;\n    memory_stats: MemoryStats;\n    networks?: NetworkStats;\n  };\n\n  const cpuStats = stats.cpu_stats;\n  const precpuStats = stats.precpu_stats;\n  const cpuDelta =\n    cpuStats.cpu_usage.total_usage - precpuStats.cpu_usage.total_usage;\n  const systemDelta = cpuStats.system_cpu_usage - precpuStats.system_cpu_usage;\n  const cpuCount = cpuStats.cpu_usage.percpu_usage?.length ?? 1;\n  const cpuPercent =\n    systemDelta > 0\n      ? ((cpuDelta / systemDelta) * cpuCount * 100).toFixed(2)\n      : \"0.00\";\n\n  const memUsage = stats.memory_stats.usage ?? 0;\n  const memLimit = stats.memory_stats.limit ?? 0;\n  const memPercent =\n    memLimit > 0 ? ((memUsage / memLimit) * 100).toFixed(2) : \"0.00\";\n\n  const networks = stats.networks ?? {};\n  let rxBytes = 0;\n  let txBytes = 0;\n  for (const iface of Object.values(networks)) {\n    rxBytes += iface.rx_bytes ?? 0;\n    txBytes += iface.tx_bytes ?? 0;\n  }\n\n  return {\n    cpu_percent: `${cpuPercent}%`,\n    memory_usage: formatBytes(memUsage),\n    memory_limit: formatBytes(memLimit),\n    memory_percent: `${memPercent}%`,\n    network_rx: formatBytes(rxBytes),\n    network_tx: formatBytes(txBytes),\n  };\n}\n\nexport async function listImages(): Promise<ImageInfo[]> {\n  const images = await docker.listImages();\n  return images.map((img) => ({\n    id: img.Id.replace(\"sha256:\", \"\").slice(0, 12),\n    tags: img.RepoTags ?? [\"<none>\"],\n    size: formatBytes(img.Size),\n    created: new Date(img.Created * 1000).toISOString(),\n  }));\n}\n\nexport async function removeImage(id: string, force: boolean): Promise<string> {\n  const image = docker.getImage(id);\n  await image.remove({ force });\n  return `Image ${id} removed`;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "mcp-docker-server",
+  "version": "1.0.0",
+  "description": "MCP server for Docker — manage containers, images, volumes, and compose services from your IDE",
+  "type": "module",
+  "bin": {
+    "mcp-docker-server": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint . && prettier --check .",
+    "format": "prettier --write .",
+    "prepare": "husky"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "docker",
+    "containers",
+    "devops",
+    "docker-compose",
+    "ai",
+    "llm",
+    "claude",
+    "cursor"
+  ],
+  "author": "Ofer Shapira",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ofershap/mcp-server-docker.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ofershap/mcp-server-docker/issues"
+  },
+  "homepage": "https://github.com/ofershap/mcp-server-docker#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "dockerode": "^4.0.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "@types/dockerode": "^3.3.0",
+    "@types/node": "^22.0.0",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^10.0.0",
+    "husky": "^9.0.0",
+    "lint-staged": "^15.0.0",
+    "prettier": "^3.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.0.0",
+    "vitest": "^3.2.0"
+  },
+  "lint-staged": {
+    "*.{ts,tsx,js}": "eslint --fix",
+    "*.{json,md,yml,yaml}": "prettier --write"
+  }
+}