read_output
Retrieve real-time output from a terminal session by specifying the process ID, enabling monitoring and management of active commands on Desktop Commander MCP.
Instructions
Read new output from a running terminal session.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pid | Yes |
Implementation Reference
- src/tools/execute.ts:30-45 (handler)The core handler function that implements the read_output tool logic. It validates input args using the schema, retrieves new output for the specified PID from the terminal manager, and returns formatted MCP content.export async function readOutput(args: unknown) { const parsed = ReadOutputArgsSchema.safeParse(args); if (!parsed.success) { throw new Error(`Invalid arguments for read_output: ${parsed.error}`); } const output = terminalManager.getNewOutput(parsed.data.pid); return { content: [{ type: "text", text: output === null ? `No session found for PID ${parsed.data.pid}` : output || 'No new output available' }], }; }
- src/tools/schemas.ts:9-11 (schema)Zod schema defining the input arguments for the read_output tool, which requires a 'pid' as a number.export const ReadOutputArgsSchema = z.object({ pid: z.number(), });
- src/server.ts:67-71 (registration)Tool registration in the MCP server's list of tools, specifying the name, description, and input schema for read_output.name: "read_output", description: "Read new output from a running terminal session.", inputSchema: zodToJsonSchema(ReadOutputArgsSchema), },
- src/server.ts:220-223 (registration)Dispatch handler in the MCP server's CallToolRequest handler that routes read_output calls to the readOutput function after parsing args.case "read_output": { const parsed = ReadOutputArgsSchema.parse(args); return readOutput(parsed); }