kill_process
Terminate a running process by PID to manage system resources and resolve unresponsive applications. Use with caution as this forcefully ends the specified process.
Instructions
Terminate a running process by PID.
Use with caution as this will forcefully terminate the specified process.
This command can be referenced as "DC: ..." or "use Desktop Commander to ..." in your instructions.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pid | Yes |
Implementation Reference
- src/handlers/process-handlers.ts:19-25 (handler)Handler function that receives the tool call for kill_process, parses the arguments using the schema, and delegates to the killProcess helper function./** * Handle kill_process command */ export async function handleKillProcess(args: unknown): Promise<ServerResult> { const parsed = KillProcessArgsSchema.parse(args); return killProcess(parsed); }
- src/tools/process.ts:42-62 (handler)Core implementation function that validates arguments (with safeParse fallback), calls Node.js process.kill(pid), and returns success or error response.export async function killProcess(args: unknown): Promise<ServerResult> { const parsed = KillProcessArgsSchema.safeParse(args); if (!parsed.success) { return { content: [{ type: "text", text: `Error: Invalid arguments for kill_process: ${parsed.error}` }], isError: true, }; } try { process.kill(parsed.data.pid); return { content: [{ type: "text", text: `Successfully terminated process ${parsed.data.pid}` }], }; } catch (error) { return { content: [{ type: "text", text: `Error: Failed to kill process: ${error instanceof Error ? error.message : String(error)}` }], isError: true, }; } }
- src/tools/schemas.ts:42-44 (schema)Zod schema defining the input arguments for kill_process tool: requires a numeric PID.export const KillProcessArgsSchema = z.object({ pid: z.number(), });
- src/server.ts:958-973 (registration)MCP tool registration object defining the name 'kill_process', description, input schema reference, and annotations for the ListTools response.{ name: "kill_process", description: ` Terminate a running process by PID. Use with caution as this will forcefully terminate the specified process. ${CMD_PREFIX_DESCRIPTION}`, inputSchema: zodToJsonSchema(KillProcessArgsSchema), annotations: { title: "Kill Process", readOnlyHint: false, destructiveHint: true, openWorldHint: false, }, },
- src/server.ts:1267-1269 (registration)Dispatch case in the CallToolRequest handler switch statement that routes 'kill_process' calls to the handleKillProcess function.case "kill_process": result = await handlers.handleKillProcess(args); break;