sandbox_stop
Terminate and remove a running Node.js sandbox container to clean up resources after completing code execution tasks.
Instructions
Terminate and remove a running sandbox container. Should be called after finishing work in a sandbox initialized with sandbox_initialize.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| container_id | Yes |
Implementation Reference
- src/tools/stop.ts:9-49 (handler)The main handler function `stopSandbox` that executes the tool logic: checks if Docker is running, stops and removes the container using `docker rm -f`, updates the active containers set, and returns appropriate success or error messages.
export default async function stopSandbox({ container_id, }: { container_id: string; }): Promise<McpResponse> { if (!isDockerRunning()) { return { content: [textContent(DOCKER_NOT_RUNNING_ERROR)], }; } try { // Directly use execSync for removing the container as expected by the test execSync(`docker rm -f ${container_id}`); activeSandboxContainers.delete(container_id); // console.log( // `[stopSandbox] Removed container ${container_id} from registry.` // ); return { content: [textContent(`Container ${container_id} removed.`)], }; } catch (error) { // Handle any errors that occur during container removal const errorMessage = error instanceof Error ? error.message : String(error); console.error( `[stopSandbox] Error removing container ${container_id}: ${errorMessage}` ); // Still remove from our registry even if Docker command failed activeSandboxContainers.delete(container_id); return { content: [ textContent( `Error removing container ${container_id}: ${errorMessage}` ), ], }; } } - src/tools/stop.ts:7-7 (schema)Zod input schema defining the required `container_id` string argument.
export const argSchema = { container_id: z.string() }; - src/server.ts:75-80 (registration)MCP server tool registration for 'sandbox_stop', linking the name, description, input schema (`stopSchema`), and handler (`stopSandbox`).
server.tool( 'sandbox_stop', 'Terminate and remove a running sandbox container. Should be called after finishing work in a sandbox initialized with sandbox_initialize.', stopSchema, stopSandbox ); - src/server.ts:15-15 (registration)Import of the handler function and schema for sandbox_stop from the tools module.
import stopSandbox, { argSchema as stopSchema } from './tools/stop.ts';