Claude Code MCP

Instructions

Implementation Reference

• src/server/tools.ts:88-103 (handler)

  MCP tool handler for listFiles that invokes the utility function and formats the response as JSON.

  async ({ path }) => {
    try {
      const files = await listFiles(path);
      return {
        content: [{ type: "text", text: JSON.stringify(files, null, 2) }]
      };
    } catch (error) {
      return {
        content: [{ 
          type: "text", 
          text: error instanceof Error ? error.message : String(error)
        }],
        isError: true
      };
    }
  }

• src/server/tools.ts:85-87 (schema)

  Zod input schema defining the 'path' parameter for the listFiles tool.

  {
    path: z.string().describe("The absolute path to the directory to list")
  },

• src/server/tools.ts:82-104 (registration)

  Registration of the listFiles MCP tool using server.tool().

  server.tool(
    "listFiles",
    "Lists files and directories in a given path",
    {
      path: z.string().describe("The absolute path to the directory to list")
    },
    async ({ path }) => {
      try {
        const files = await listFiles(path);
        return {
          content: [{ type: "text", text: JSON.stringify(files, null, 2) }]
        };
      } catch (error) {
        return {
          content: [{ 
            type: "text", 
            text: error instanceof Error ? error.message : String(error)
          }],
          isError: true
        };
      }
    }
  );

• src/utils/file.ts:41-62 (helper)

  Helper utility function that lists files in a directory with details using Node.js fs module.

  export async function listFiles(dirPath: string): Promise<any[]> {
    try {
      const files = await fs.readdir(dirPath);
      const fileDetails = await Promise.all(
        files.map(async (file) => {
          const filePath = path.join(dirPath, file);
          const stats = await fs.stat(filePath);
          return {
            name: file,
            path: filePath,
            isDirectory: stats.isDirectory(),
            size: stats.size,
            modified: stats.mtime.toISOString()
          };
        })
      );
      
      return fileDetails;
    } catch (error) {
      throw error;
    }
  }