Desktop Commander MCP

Instructions

Implementation Reference

• src/server.ts:1254-1256 (registration)

  Dispatch handler for the 'force_terminate' tool call in MCP server request handler
  case "force_terminate": result = await handlers.handleForceTerminate(args); break;
• src/server.ts:908-921 (registration)

  Tool registration in list_tools handler defining name, description, input schema, and annotations for 'force_terminate'
  { name: "force_terminate", description: ` Force terminate a running terminal session. ${CMD_PREFIX_DESCRIPTION}`, inputSchema: zodToJsonSchema(ForceTerminateArgsSchema), annotations: { title: "Force Terminate Process", readOnlyHint: false, destructiveHint: true, openWorldHint: false, }, },
• src/handlers/terminal-handlers.ts:42-48 (handler)

  MCP tool handler function that validates input with schema and delegates to forceTerminate implementation
  /** * Handle force_terminate command */ export async function handleForceTerminate(args: unknown): Promise<ServerResult> { const parsed = ForceTerminateArgsSchema.parse(args); return forceTerminate(parsed); }
• src/tools/schemas.ts:36-38 (schema)

  Zod schema defining input parameters for force_terminate tool (requires pid: number)
  export const ForceTerminateArgsSchema = z.object({ pid: z.number(), });
• src/tools/improved-process-tools.ts:652-683 (helper)

  Core forceTerminate function that handles argument parsing, virtual sessions, and delegates to terminalManager.forceTerminate
  export async function forceTerminate(args: unknown): Promise<ServerResult> { const parsed = ForceTerminateArgsSchema.safeParse(args); if (!parsed.success) { return { content: [{ type: "text", text: `Error: Invalid arguments for force_terminate: ${parsed.error}` }], isError: true, }; } const pid = parsed.data.pid; // Handle virtual Node.js sessions (node:local) if (virtualNodeSessions.has(pid)) { virtualNodeSessions.delete(pid); return { content: [{ type: "text", text: `Cleared virtual Node.js session ${pid}` }], }; } const success = terminalManager.forceTerminate(pid); return { content: [{ type: "text", text: success ? `Successfully initiated termination of session ${pid}` : `No active session found for PID ${pid}` }], }; }
• src/terminal-manager.ts:591-611 (helper)

  TerminalManager.forceTerminate method that sends SIGINT followed by SIGKILL if needed to terminate the process
  forceTerminate(pid: number): boolean { const session = this.sessions.get(pid); if (!session) { return false; } try { session.process.kill('SIGINT'); setTimeout(() => { if (this.sessions.has(pid)) { session.process.kill('SIGKILL'); } }, 1000); return true; } catch (error) { // Convert error to string, handling both Error objects and other types const errorMessage = error instanceof Error ? error.message : String(error); capture('server_request_error', {error: errorMessage, message: `Failed to terminate process ${pid}:`}); return false; } }