Claude Desktop Commander MCP

Instructions

Implementation Reference

• src/tools/execute.ts:47-62 (handler)

  Main handler function for the 'force_terminate' tool. Parses input arguments using the schema, calls the terminal manager to terminate the process, and returns a formatted response.

  export async function forceTerminate(args: unknown) {
    const parsed = ForceTerminateArgsSchema.safeParse(args);
    if (!parsed.success) {
      throw new Error(`Invalid arguments for force_terminate: ${parsed.error}`);
    }
  
    const success = terminalManager.forceTerminate(parsed.data.pid);
    return {
      content: [{
        type: "text",
        text: success
          ? `Successfully initiated termination of session ${parsed.data.pid}`
          : `No active session found for PID ${parsed.data.pid}`
      }],
    };
  }

• src/tools/schemas.ts:13-15 (schema)

  Zod schema defining the input arguments for the force_terminate tool: requires a numeric PID.

  export const ForceTerminateArgsSchema = z.object({
    pid: z.number(),
  });

• src/server.ts:72-77 (registration)

  Registration of the 'force_terminate' tool in the server's listTools response, specifying name, description, and input schema.

  {
    name: "force_terminate",
    description:
      "Force terminate a running terminal session.",
    inputSchema: zodToJsonSchema(ForceTerminateArgsSchema),
  },

• src/server.ts:224-227 (registration)

  Dispatch handler in the server's callTool request handler that parses arguments and delegates to the forceTerminate function.

  case "force_terminate": {
    const parsed = ForceTerminateArgsSchema.parse(args);
    return forceTerminate(parsed);
  }

• src/terminal-manager.ts:106-124 (helper)

  Core implementation in TerminalManager that force terminates a process by PID using SIGINT followed by SIGKILL if necessary.

  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) {
      console.error(`Failed to terminate process ${pid}:`, error);
      return false;
    }
  }