@supernova123/docker-mcp-server 0.2.0 → 0.2.1

package/dist/tools/monitoring.js

@@ -1,7 +1,7 @@
-import { FleetStatusSchema, FleetStatsSchema, WatchEventsSchema, SearchLogsSchema, CheckThresholdsSchema, MonitorDashboardSchema, } from "../types.js";
+import { ContainerHealthStatusSchema, ContainerResourceUsageSchema, WatchEventsSchema, SearchLogsSchema, ResourceAlertCheckSchema, MonitorDashboardSchema, } from "../types.js";
 export function registerMonitoringTools(server, docker) {
     // 1. fleet_status — health status of all running containers
-    server.tool("fleet_status", "Get health status of all running containers. Returns name, state, health, uptime, and restart count for each.", FleetStatusSchema.shape, async (params) => {
+    server.tool("container_health_status", "Check health status, uptime, and restart count for all running Docker containers. Returns JSON with container name, state, health probe status, and restart count.", ContainerHealthStatusSchema.shape, async (params) => {
         try {
             const containers = await docker.listContainers({ all: false });
             const results = await Promise.all(containers.map(async (c) => {
@@ -29,7 +29,7 @@ export function registerMonitoringTools(server, docker) {
         }
     });
     // 2. fleet_stats — resource usage for all running containers
-    server.tool("fleet_stats", "Get resource usage (CPU%, memory%, network I/O) for all running containers. Sorted by usage.", FleetStatsSchema.shape, async (params) => {
+    server.tool("container_resource_usage", "Monitor CPU, memory, and network I/O across all running Docker containers. Returns sorted resource usage metrics with percentage breakdowns.", ContainerResourceUsageSchema.shape, async (params) => {
         try {
             const containers = await docker.listContainers({ all: false });
             const results = await Promise.all(containers.map(async (c) => {
@@ -73,7 +73,7 @@ export function registerMonitoringTools(server, docker) {
         }
     });
     // 3. watch_events — stream Docker events (simplified: collect events for a duration)
-    server.tool("watch_events", "Collect Docker events (start, stop, die, restart, health_status) over a time window. Filter by container or event type.", WatchEventsSchema.shape, async (params) => {
+    server.tool("watch_events", "Stream Docker container events (start, stop, die, restart, health_status) over a configurable time window. Filter by specific container or event type.", WatchEventsSchema.shape, async (params) => {
         try {
             const durationMs = (params.duration || 30) * 1000;
             const filter = {};
@@ -122,7 +122,7 @@ export function registerMonitoringTools(server, docker) {
         }
     });
     // 4. search_logs — search logs across multiple containers
-    server.tool("search_logs", "Search logs across multiple containers with regex/grep pattern. Returns matching lines with container name and timestamp.", SearchLogsSchema.shape, async (params) => {
+    server.tool("search_logs", "Search Docker container logs across multiple containers using regex pattern matching. Returns matching log lines with container name and timestamp.", SearchLogsSchema.shape, async (params) => {
         try {
             const targetContainers = params.containers || [];
             let containers;
@@ -168,7 +168,7 @@ export function registerMonitoringTools(server, docker) {
         }
     });
     // 5. check_thresholds — check all containers against thresholds
-    server.tool("check_thresholds", "Check all containers against defined thresholds (CPU > X%, memory > Y%, restarts > Z). Returns violations.", CheckThresholdsSchema.shape, async (params) => {
+    server.tool("resource_alert_check", "Alert when Docker containers exceed resource thresholds (CPU%, memory%, restart count). Returns violations with specific metrics that triggered alerts.", ResourceAlertCheckSchema.shape, async (params) => {
         try {
             const cpuThreshold = params.cpu_percent ?? 80;
             const memThreshold = params.memory_percent ?? 80;
@@ -223,7 +223,7 @@ export function registerMonitoringTools(server, docker) {
         }
     });
     // 6. monitor_dashboard — single-call fleet summary
-    server.tool("monitor_dashboard", "Single-call fleet summary: health status, top resource consumers, recent events, threshold violations. Designed for agent quick-assessment.", MonitorDashboardSchema.shape, async (params) => {
+    server.tool("monitor_dashboard", "Comprehensive Docker fleet dashboard in a single API call. Returns health status, top resource consumers, recent events, and threshold violations.", MonitorDashboardSchema.shape, async (params) => {
         try {
             const containers = await docker.listContainers({ all: false });
             // Fleet health

package/dist/types.d.ts

@@ -306,8 +306,8 @@ export declare const ListVolumesSchema: z.ZodObject<{
 }, {
     filter?: string | undefined;
 }>;
-export declare const FleetStatusSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
-export declare const FleetStatsSchema: z.ZodObject<{
+export declare const ContainerHealthStatusSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const ContainerResourceUsageSchema: z.ZodObject<{
     sort_by: z.ZodOptional<z.ZodEnum<["cpu", "memory", "network"]>>;
 }, "strip", z.ZodTypeAny, {
     sort_by?: "cpu" | "memory" | "network" | undefined;
@@ -349,7 +349,7 @@ export declare const SearchLogsSchema: z.ZodObject<{
     containers?: string[] | undefined;
     ignore_case?: boolean | undefined;
 }>;
-export declare const CheckThresholdsSchema: z.ZodObject<{
+export declare const ResourceAlertCheckSchema: z.ZodObject<{
     cpu_percent: z.ZodOptional<z.ZodNumber>;
     memory_percent: z.ZodOptional<z.ZodNumber>;
     restart_count: z.ZodOptional<z.ZodNumber>;

package/dist/types.js

@@ -126,8 +126,8 @@ export const ListVolumesSchema = z.object({
     filter: z.string().optional().describe("Filter by name or driver"),
 });
 // Monitoring schemas (v0.2.0)
-export const FleetStatusSchema = z.object({});
-export const FleetStatsSchema = z.object({
+export const ContainerHealthStatusSchema = z.object({});
+export const ContainerResourceUsageSchema = z.object({
     sort_by: z.enum(["cpu", "memory", "network"]).optional().describe("Sort results by metric (default: cpu)"),
 });
 export const WatchEventsSchema = z.object({
@@ -143,7 +143,7 @@ export const SearchLogsSchema = z.object({
     since: z.string().optional().describe("Only search logs since timestamp"),
     ignore_case: z.boolean().optional().describe("Case-insensitive search (default: false)"),
 });
-export const CheckThresholdsSchema = z.object({
+export const ResourceAlertCheckSchema = z.object({
     cpu_percent: z.number().optional().describe("Alert if CPU usage exceeds this % (default: 80)"),
     memory_percent: z.number().optional().describe("Alert if memory usage exceeds this % (default: 80)"),
     restart_count: z.number().optional().describe("Alert if restart count exceeds this (default: 5)"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supernova123/docker-mcp-server",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "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",
   "type": "module",
@@ -18,19 +18,31 @@
   "keywords": [
     "mcp",
     "mcp-server",
+    "model-context-protocol",
     "docker",
     "docker-mcp",
     "container",
+    "containers",
     "compose",
+    "docker-compose",
     "health-check",
+    "health-monitoring",
+    "container-health",
     "devops",
+    "infrastructure",
+    "orchestration",
     "ai-agent",
-    "model-context-protocol",
+    "ai-agents",
     "claude",
     "cursor",
     "chatgpt",
     "claude-desktop",
-    "ai"
+    "monitoring",
+    "resource-monitoring",
+    "log-search",
+    "container-logs",
+    "docker-events",
+    "fleet-management"
   ],
   "author": "Nova",
   "license": "MIT",
@@ -53,4 +65,4 @@
     "typescript": "^5.7.0",
     "vitest": "^3.1.0"
   }
-}
+}

package/src/tools/monitoring.ts

@@ -1,20 +1,20 @@
 import Dockerode from "dockerode";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import {
-  FleetStatusSchema,
-  FleetStatsSchema,
+  ContainerHealthStatusSchema,
+  ContainerResourceUsageSchema,
   WatchEventsSchema,
   SearchLogsSchema,
-  CheckThresholdsSchema,
+  ResourceAlertCheckSchema,
   MonitorDashboardSchema,
 } from "../types.js";
 
 export function registerMonitoringTools(server: McpServer, docker: Dockerode): void {
   // 1. fleet_status — health status of all running containers
   server.tool(
-    "fleet_status",
-    "Get health status of all running containers. Returns name, state, health, uptime, and restart count for each.",
-    FleetStatusSchema.shape,
+    "container_health_status",
+    "Check health status, uptime, and restart count for all running Docker containers. Returns JSON with container name, state, health probe status, and restart count.",
+    ContainerHealthStatusSchema.shape,
     async (params) => {
       try {
         const containers = await docker.listContainers({ all: false });
@@ -47,9 +47,9 @@ export function registerMonitoringTools(server: McpServer, docker: Dockerode): v
 
   // 2. fleet_stats — resource usage for all running containers
   server.tool(
-    "fleet_stats",
-    "Get resource usage (CPU%, memory%, network I/O) for all running containers. Sorted by usage.",
-    FleetStatsSchema.shape,
+    "container_resource_usage",
+    "Monitor CPU, memory, and network I/O across all running Docker containers. Returns sorted resource usage metrics with percentage breakdowns.",
+    ContainerResourceUsageSchema.shape,
     async (params) => {
       try {
         const containers = await docker.listContainers({ all: false });
@@ -100,7 +100,7 @@ export function registerMonitoringTools(server: McpServer, docker: Dockerode): v
   // 3. watch_events — stream Docker events (simplified: collect events for a duration)
   server.tool(
     "watch_events",
-    "Collect Docker events (start, stop, die, restart, health_status) over a time window. Filter by container or event type.",
+    "Stream Docker container events (start, stop, die, restart, health_status) over a configurable time window. Filter by specific container or event type.",
     WatchEventsSchema.shape,
     async (params) => {
       try {
@@ -156,7 +156,7 @@ export function registerMonitoringTools(server: McpServer, docker: Dockerode): v
   // 4. search_logs — search logs across multiple containers
   server.tool(
     "search_logs",
-    "Search logs across multiple containers with regex/grep pattern. Returns matching lines with container name and timestamp.",
+    "Search Docker container logs across multiple containers using regex pattern matching. Returns matching log lines with container name and timestamp.",
     SearchLogsSchema.shape,
     async (params) => {
       try {
@@ -210,9 +210,9 @@ export function registerMonitoringTools(server: McpServer, docker: Dockerode): v
 
   // 5. check_thresholds — check all containers against thresholds
   server.tool(
-    "check_thresholds",
-    "Check all containers against defined thresholds (CPU > X%, memory > Y%, restarts > Z). Returns violations.",
-    CheckThresholdsSchema.shape,
+    "resource_alert_check",
+    "Alert when Docker containers exceed resource thresholds (CPU%, memory%, restart count). Returns violations with specific metrics that triggered alerts.",
+    ResourceAlertCheckSchema.shape,
     async (params) => {
       try {
         const cpuThreshold = params.cpu_percent ?? 80;
@@ -274,7 +274,7 @@ export function registerMonitoringTools(server: McpServer, docker: Dockerode): v
   // 6. monitor_dashboard — single-call fleet summary
   server.tool(
     "monitor_dashboard",
-    "Single-call fleet summary: health status, top resource consumers, recent events, threshold violations. Designed for agent quick-assessment.",
+    "Comprehensive Docker fleet dashboard in a single API call. Returns health status, top resource consumers, recent events, and threshold violations.",
     MonitorDashboardSchema.shape,
     async (params) => {
       try {
@@ -366,4 +366,4 @@ export function registerMonitoringTools(server: McpServer, docker: Dockerode): v
       }
     }
   );
-}
+}

package/src/types.ts

@@ -153,9 +153,9 @@ export const ListVolumesSchema = z.object({
 
 
 // Monitoring schemas (v0.2.0)
-export const FleetStatusSchema = z.object({});
+export const ContainerHealthStatusSchema = z.object({});
 
-export const FleetStatsSchema = z.object({
+export const ContainerResourceUsageSchema = z.object({
   sort_by: z.enum(["cpu", "memory", "network"]).optional().describe("Sort results by metric (default: cpu)"),
 });
 
@@ -174,10 +174,10 @@ export const SearchLogsSchema = z.object({
   ignore_case: z.boolean().optional().describe("Case-insensitive search (default: false)"),
 });
 
-export const CheckThresholdsSchema = z.object({
+export const ResourceAlertCheckSchema = z.object({
   cpu_percent: z.number().optional().describe("Alert if CPU usage exceeds this % (default: 80)"),
   memory_percent: z.number().optional().describe("Alert if memory usage exceeds this % (default: 80)"),
   restart_count: z.number().optional().describe("Alert if restart count exceeds this (default: 5)"),
 });
 
-export const MonitorDashboardSchema = z.object({});
+export const MonitorDashboardSchema = z.object({});

package/tests/monitoring.test.ts

@@ -104,14 +104,14 @@ describe("Monitoring Tools", () => {
     registerMonitoringTools(server, docker);
   });
 
-  describe("fleet_status", () => {
+  describe("container_health_status", () => {
     it("returns health status for all running containers", async () => {
       mockContainers(["abc123", "def456"], ["web", "db"]);
       mockInspect
         .mockResolvedValueOnce(mockInspectResult({ RestartCount: 2 }))
         .mockResolvedValueOnce(mockInspectResult({ RestartCount: 0, State: { Running: true, StartedAt: "2026-06-15T11:00:00Z", Health: { Status: "unhealthy" } } }));
 
-      const result = await server.tools["fleet_status"].handler({});
+      const result = await server.tools["container_health_status"].handler({});
       const data = JSON.parse(result.content[0].text);
 
       expect(data).toHaveLength(2);
@@ -128,7 +128,7 @@ describe("Monitoring Tools", () => {
         State: { Running: true, StartedAt: "2026-06-15T10:00:00Z" },
       }));
 
-      const result = await server.tools["fleet_status"].handler({});
+      const result = await server.tools["container_health_status"].handler({});
       const data = JSON.parse(result.content[0].text);
 
       expect(data[0].health).toBe("no-healthcheck");
@@ -136,14 +136,14 @@ describe("Monitoring Tools", () => {
 
     it("returns error on Docker failure", async () => {
       mockListContainers.mockRejectedValue(new Error("Docker daemon not running"));
-      const result = await server.tools["fleet_status"].handler({});
+      const result = await server.tools["container_health_status"].handler({});
 
       expect(result.isError).toBe(true);
       expect(result.content[0].text).toContain("Docker daemon not running");
     });
   });
 
-  describe("fleet_stats", () => {
+  describe("container_resource_usage", () => {
     it("returns resource usage sorted by CPU by default", async () => {
       mockContainers(["abc123", "def456"], ["low-cpu", "high-cpu"]);
       mockStats
@@ -156,7 +156,7 @@ describe("Monitoring Tools", () => {
           precpu_stats: { cpu_usage: { total_usage: 100000 }, system_cpu_usage: 9500000 },
         }));
 
-      const result = await server.tools["fleet_stats"].handler({});
+      const result = await server.tools["container_resource_usage"].handler({});
       const data = JSON.parse(result.content[0].text);
 
       expect(data).toHaveLength(2);
@@ -177,7 +177,7 @@ describe("Monitoring Tools", () => {
           memory_stats: { usage: 900 * 1024 * 1024, limit: 1024 * 1024 * 1024 },
         }));
 
-      const result = await server.tools["fleet_stats"].handler({ sort_by: "memory" });
+      const result = await server.tools["container_resource_usage"].handler({ sort_by: "memory" });
       const data = JSON.parse(result.content[0].text);
 
       expect(data[0].name).toBe("high-mem");
@@ -186,7 +186,7 @@ describe("Monitoring Tools", () => {
 
     it("returns error on Docker failure", async () => {
       mockListContainers.mockRejectedValue(new Error("Cannot connect"));
-      const result = await server.tools["fleet_stats"].handler({});
+      const result = await server.tools["container_resource_usage"].handler({});
 
       expect(result.isError).toBe(true);
       expect(result.content[0].text).toContain("Cannot connect");
@@ -296,7 +296,7 @@ describe("Monitoring Tools", () => {
     });
   });
 
-  describe("check_thresholds", () => {
+  describe("resource_alert_check", () => {
     it("returns violations when containers exceed thresholds", async () => {
       mockContainers(["abc123"], ["high-cpu"]);
       mockInspect.mockResolvedValue(mockInspectResult({ RestartCount: 10 }));
@@ -305,7 +305,7 @@ describe("Monitoring Tools", () => {
         precpu_stats: { cpu_usage: { total_usage: 1000000 }, system_cpu_usage: 9500000 },
       }));
 
-      const result = await server.tools["check_thresholds"].handler({ cpu_percent: 80, restart_count: 5 });
+      const result = await server.tools["resource_alert_check"].handler({ cpu_percent: 80, restart_count: 5 });
       const data = JSON.parse(result.content[0].text);
 
       expect(data.violations).toHaveLength(1);
@@ -323,7 +323,7 @@ describe("Monitoring Tools", () => {
         precpu_stats: { cpu_usage: { total_usage: 90000 }, system_cpu_usage: 9500000 },
       }));
 
-      const result = await server.tools["check_thresholds"].handler({});
+      const result = await server.tools["resource_alert_check"].handler({});
       const data = JSON.parse(result.content[0].text);
 
       expect(data.message).toContain("All containers within thresholds");
@@ -338,7 +338,7 @@ describe("Monitoring Tools", () => {
         precpu_stats: { cpu_usage: { total_usage: 90000 }, system_cpu_usage: 9500000 },
       }));
 
-      const result = await server.tools["check_thresholds"].handler({});
+      const result = await server.tools["resource_alert_check"].handler({});
       const data = JSON.parse(result.content[0].text);
 
       expect(data.message).toContain("All containers within thresholds");
@@ -346,7 +346,7 @@ describe("Monitoring Tools", () => {
 
     it("returns error on Docker failure", async () => {
       mockListContainers.mockRejectedValue(new Error("Daemon down"));
-      const result = await server.tools["check_thresholds"].handler({});
+      const result = await server.tools["resource_alert_check"].handler({});
 
       expect(result.isError).toBe(true);
       expect(result.content[0].text).toContain("Daemon down");
@@ -408,4 +408,4 @@ describe("Monitoring Tools", () => {
       expect(result.content[0].text).toContain("Connection refused");
     });
   });
-});
+});