Claude Desktop Commander MCP

Instructions

Implementation Reference

• src/tools/process.ts:39-54 (handler)

  The core handler function that validates input using KillProcessArgsSchema, kills the process using Node.js process.kill(pid), and returns a success message or throws an error.

  export async function killProcess(args: unknown) {
  
    const parsed = KillProcessArgsSchema.safeParse(args);
    if (!parsed.success) {
      throw new Error(`Invalid arguments for kill_process: ${parsed.error}`);
    }
  
    try {
      process.kill(parsed.data.pid);
      return {
        content: [{ type: "text", text: `Successfully terminated process ${parsed.data.pid}` }],
      };
    } catch (error) {
      throw new Error(`Failed to kill process: ${error instanceof Error ? error.message : String(error)}`);
    }
  }

• src/tools/schemas.ts:19-21 (schema)

  Zod schema defining the input arguments for the kill_process tool: requires a 'pid' number.

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

• src/server.ts:96-101 (registration)

  Tool registration in the ListTools response, defining name, description, and input schema.

    name: "kill_process",
    description:
      "Terminate a running process by PID. Use with caution as this will " +
      "forcefully terminate the specified process.",
    inputSchema: zodToJsonSchema(KillProcessArgsSchema),
  },

• src/server.ts:232-235 (registration)

  Dispatch logic in the CallTool handler switch statement, which parses args and calls the killProcess handler.

  case "kill_process": {
    const parsed = KillProcessArgsSchema.parse(args);
    return killProcess(parsed);
  }

• src/server.ts:28-28 (registration)

  Import statement bringing in the killProcess handler function.

  import { listProcesses, killProcess } from './tools/process.js';