Desktop Commander MCP

Instructions

Implementation Reference

• src/tools/config.ts:10-56 (handler)

  The handler function that implements the core logic of the 'get_config' tool. It retrieves the server configuration, enriches it with system information, memory usage, current client details, and feature flags, then returns it as formatted JSON text content.
  export async function getConfig() { console.error('getConfig called'); try { const config = await configManager.getConfig(); // Add system information and current client to the config response const systemInfo = getSystemInfo(); // Get memory usage const memoryUsage = process.memoryUsage(); const memory = { rss: `${(memoryUsage.rss / 1024 / 1024).toFixed(2)} MB`, heapTotal: `${(memoryUsage.heapTotal / 1024 / 1024).toFixed(2)} MB`, heapUsed: `${(memoryUsage.heapUsed / 1024 / 1024).toFixed(2)} MB`, external: `${(memoryUsage.external / 1024 / 1024).toFixed(2)} MB`, arrayBuffers: `${(memoryUsage.arrayBuffers / 1024 / 1024).toFixed(2)} MB` }; const configWithSystemInfo = { ...config, currentClient, featureFlags: featureFlagManager.getAll(), systemInfo: { ...systemInfo, memory } }; console.error(`getConfig result: ${JSON.stringify(configWithSystemInfo, null, 2)}`); return { content: [{ type: "text", text: `Current configuration:\n${JSON.stringify(configWithSystemInfo, null, 2)}` }], }; } catch (error) { console.error(`Error in getConfig: ${error instanceof Error ? error.message : String(error)}`); console.error(error instanceof Error && error.stack ? error.stack : 'No stack trace available'); // Return empty config rather than crashing return { content: [{ type: "text", text: `Error getting configuration: ${error instanceof Error ? error.message : String(error)}\nUsing empty configuration.` }], }; } }
• src/tools/schemas.ts:4-4 (schema)

  The Zod schema for input arguments to the 'get_config' tool, which accepts no parameters.
  export const GetConfigArgsSchema = z.object({});
• src/server.ts:191-210 (registration)

  Tool registration in the list_tools handler, defining the name, description, input schema, and annotations for the 'get_config' tool.
  name: "get_config", description: ` Get the complete server configuration as JSON. Config includes fields for: - blockedCommands (array of blocked shell commands) - defaultShell (shell to use for commands) - allowedDirectories (paths the server can access) - fileReadLineLimit (max lines for read_file, default 1000) - fileWriteLineLimit (max lines per write_file call, default 50) - telemetryEnabled (boolean for telemetry opt-in/out) - currentClient (information about the currently connected MCP client) - clientHistory (history of all clients that have connected) - version (version of the DesktopCommander) - systemInfo (operating system and environment details) ${CMD_PREFIX_DESCRIPTION}`, inputSchema: zodToJsonSchema(GetConfigArgsSchema), annotations: { title: "Get Configuration", readOnlyHint: true, }, },
• src/server.ts:1136-1146 (registration)

  Dispatch handler in the call_tool request handler that routes 'get_config' calls to the getConfig implementation function.
  case "get_config": try { result = await getConfig(); } catch (error) { capture('server_request_error', { message: `Error in get_config handler: ${error}` }); result = { content: [{ type: "text", text: `Error: Failed to get configuration` }], isError: true, }; } break;