list_containers
Display Docker containers to monitor running instances or view all containers including stopped ones for container management.
Instructions
List Docker containers. By default shows only running containers, use all=true to show all containers including stopped ones.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| all | No | Show all containers (default shows just running) |
Implementation Reference
- src/tools/list-containers.ts:9-64 (handler)The async handler function that executes the tool logic: lists Docker containers (running or all), formats their details (name, ID, image, state, status, ports), handles empty list and errors, returns formatted text content.
async function handler(params: z.infer<typeof inputSchema>, context: ToolContext): Promise<CallToolResult> { const { all } = params; const { docker } = context; try { const containers = await docker.listContainers({ all }); if (containers.length === 0) { return { content: [{ type: 'text', text: all ? 'No containers found.' : 'No running containers found. Use all=true to see all containers.' }] }; } // Format container list let output = `${all ? 'All' : 'Running'} Containers:\n${'='.repeat(80)}\n\n`; for (const container of containers) { const name = container.Names?.map(n => n.replace(/^\//, '')).join(', ') || 'unknown'; const image = container.Image; const status = container.Status; const state = container.State; const ports = container.Ports?.map(p => { if (p.PublicPort) { return `${p.IP || '0.0.0.0'}:${p.PublicPort}->${p.PrivatePort}/${p.Type}`; } return `${p.PrivatePort}/${p.Type}`; }).join(', ') || 'none'; output += `Name: ${name}\n`; output += `ID: ${container.Id.substring(0, 12)}\n`; output += `Image: ${image}\n`; output += `State: ${state}\n`; output += `Status: ${status}\n`; output += `Ports: ${ports}\n`; output += '-'.repeat(80) + '\n\n'; } return { content: [{ type: 'text', text: output.trim() }] }; } catch (error) { return { content: [{ type: 'text', text: `Error listing containers: ${error instanceof Error ? error.message : 'Unknown error'}` }] }; } } - src/tools/list-containers.ts:5-7 (schema)Zod schema for tool input: optional 'all' boolean to show all containers including stopped ones.
const inputSchema = z.object({ all: z.boolean().optional().default(false).describe('Show all containers (default shows just running)') }); - src/tools/list-containers.ts:66-71 (registration)ToolDefinition export bundling name, description, inputSchema, and handler for the list_containers tool.
export const listContainers: ToolDefinition = { name: 'list_containers', description: 'List Docker containers. By default shows only running containers, use all=true to show all containers including stopped ones.', inputSchema, handler }; - src/tools/registry.ts:16-20 (registration)Central registry where listContainers is included in the AVAILABLE_TOOLS array for tool discovery.
export const AVAILABLE_TOOLS: ToolDefinition[] = [ execCommand, listContainers, getContainerInfo ];