Skip to main content
Glama
ConnorBoetig-dev

Unrestricted Development MCP Server

docker_stop

Stop running Docker containers by name or ID to halt application processes and free system resources for development environments.

Instructions

Stop one or more running containers

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
containersYesContainer name(s) or ID(s)
timeoutNoSeconds to wait before killing container
cwdNoWorking directory

Implementation Reference

  • The main handler function for the docker_stop tool that constructs and executes the 'docker stop' command via the executeDockerCommand helper.
    export async function dockerStop(args: z.infer<typeof dockerStopSchema>): Promise<ToolResponse> { const containers = Array.isArray(args.containers) ? args.containers.join(' ') : args.containers; const timeoutFlag = args.timeout ? `-t ${args.timeout}` : ''; return executeDockerCommand(`docker stop ${timeoutFlag} ${containers}`.trim(), args.cwd); }
  • Zod input validation schema for the docker_stop tool.
    export const dockerStopSchema = z.object({ containers: z.union([z.string(), z.array(z.string())]).describe('Container name(s) or ID(s)'), timeout: z.number().optional().describe('Seconds to wait before killing container'), cwd: z.string().optional().describe('Working directory') });
  • MCP tool registration definition in dockerTools array (used for tool listing), including name, description, and JSON input schema.
    { name: 'docker_stop', description: 'Stop one or more running containers', inputSchema: { type: 'object', properties: { containers: { oneOf: [ { type: 'string' }, { type: 'array', items: { type: 'string' } } ], description: 'Container name(s) or ID(s)' }, timeout: { type: 'number', description: 'Seconds to wait before killing container' }, cwd: { type: 'string', description: 'Working directory' } }, required: ['containers'] } },
  • src/index.ts:459-462 (registration)
    Dispatch/registration logic in the main CallToolRequest handler that validates arguments with dockerStopSchema and calls the dockerStop handler function.
    if (name === 'docker_stop') { const validated = dockerStopSchema.parse(args); return await dockerStop(validated); }
  • Shared helper function used by all Docker tools (including dockerStop) to execute docker commands and format responses.
    async function executeDockerCommand(command: string, cwd?: string): Promise<ToolResponse> { try { const { stdout, stderr } = await execAsync(command, { cwd: cwd || process.cwd(), shell: '/bin/bash', maxBuffer: 10 * 1024 * 1024, // 10MB buffer for logs timeout: 60000 // 60 second timeout for builds }); return { content: [ { type: "text" as const, text: JSON.stringify({ success: true, command: command, stdout: stdout.trim(), stderr: stderr.trim(), cwd: cwd || process.cwd() }, null, 2) } ] }; } catch (error: any) { return { content: [ { type: "text" as const, text: JSON.stringify({ success: false, command: command, stdout: error.stdout?.trim() || '', stderr: error.stderr?.trim() || error.message, exitCode: error.code || 1, cwd: cwd || process.cwd() }, null, 2) } ], isError: true }; } }

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ConnorBoetig-dev/mcp2'

If you have feedback or need assistance with the MCP directory API, please join our Discord server