MCP PC Control Server

Instructions

Implementation Reference

• src/index.ts:427-455 (handler)

  Handler function for get_file_info tool that retrieves file stats using fs.stat and returns formatted JSON with file metadata including type, size, timestamps, and permissions.

  case "get_file_info": {
    const filePath = args.path as string;
    const stats = await fs.stat(filePath);
  
    const info = {
      path: filePath,
      type: stats.isDirectory()
        ? "directory"
        : stats.isFile()
        ? "file"
        : "other",
      size: stats.size,
      created: stats.birthtime.toISOString(),
      modified: stats.mtime.toISOString(),
      accessed: stats.atime.toISOString(),
      permissions: stats.mode.toString(8).slice(-3),
      isReadable: fsSync.constants.R_OK,
      isWritable: fsSync.constants.W_OK,
    };
  
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(info, null, 2),
        },
      ],
    };
  }

• src/index.ts:158-171 (schema)

  Tool schema definition including name, description, and input schema requiring a 'path' parameter.

  {
    name: "get_file_info",
    description: "Retrieve detailed metadata about a file or directory, including size, creation time, modification time, access time, type, and permissions. This does not read file contents.",
    inputSchema: {
      type: "object",
      properties: {
        path: {
          type: "string",
          description: "The path to the file/directory",
        },
      },
      required: ["path"],
    },
  },

• src/index.ts:261-263 (registration)

  Registration of listTools handler that returns the TOOLS array containing get_file_info.

  server.setRequestHandler(ListToolsRequestSchema, async () => {
    return { tools: TOOLS };
  });