Desktop Commander MCP

Instructions

Implementation Reference

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

  The main handler function for the get_config tool. Fetches the server config, adds system info, memory usage, current client, and feature flags, then returns formatted JSON.
  /** * Get the entire config including system information */ 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:3-5 (schema)

  Zod schema for get_config input arguments (empty object, no parameters required).
  // Config tools schemas export const GetConfigArgsSchema = z.object({});
• src/server.ts:184-204 (registration)

  Tool registration in list_tools handler: defines name, description, inputSchema using GetConfigArgsSchema, and annotations.
  { 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:1099-1108 (registration)

  Dispatch in call_tool handler: calls the getConfig() implementation from tools/config.ts.
  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, }; }
• src/server.ts:51-51 (registration)

  Import of the getConfig handler function.
  import { getConfig, setConfigValue } from './tools/config.js';