Claude Desktop Commander MCP

Instructions

Implementation Reference

• src/tools/filesystem.ts:137-150 (handler)

  The core handler function that validates the file path security and retrieves file/directory stats including size, timestamps, type, and permissions.

  export async function getFileInfo(filePath: string): Promise<Record<string, any>> {
      const validPath = await validatePath(filePath);
      const stats = await fs.stat(validPath);
      
      return {
          size: stats.size,
          created: stats.birthtime,
          modified: stats.mtime,
          accessed: stats.atime,
          isDirectory: stats.isDirectory(),
          isFile: stats.isFile(),
          permissions: stats.mode.toString(8).slice(-3),
      };
  }

• src/tools/schemas.ts:63-65 (schema)

  Zod schema for input validation of the get_file_info tool, requiring a single 'path' string parameter.

  export const GetFileInfoArgsSchema = z.object({
    path: z.string(),
  });

• src/server.ts:180-187 (registration)

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

  {
    name: "get_file_info",
    description:
      "Retrieve detailed metadata about a file or directory including size, " +
      "creation time, last modified time, permissions, and type. " +
      "Only works within allowed directories.",
    inputSchema: zodToJsonSchema(GetFileInfoArgsSchema),
  },

• src/server.ts:315-326 (registration)

  Dispatcher case in CallToolRequestHandler that parses input, calls getFileInfo handler, and formats the response.

  case "get_file_info": {
    const parsed = GetFileInfoArgsSchema.parse(args);
    const info = await getFileInfo(parsed.path);
    return {
      content: [{ 
        type: "text", 
        text: Object.entries(info)
          .map(([key, value]) => `${key}: ${value}`)
          .join('\n') 
      }],
    };
  }