mcp-uimax

Instructions

Implementation Reference

• src/server.ts:151-182 (handler)

  The handler function for the export_report tool, which initiates a full review and generates/writes the HTML report.

  async ({ url, codeDirectory, outputPath }) => {
    try {
      const resolvedPath = resolve(outputPath ?? "./uimax-report.html");
  
      // Run the full audit pipeline
      const reviewData = await runFullReview(url, codeDirectory);
  
      // Generate the self-contained HTML report
      const html = generateHtmlReport(reviewData);
  
      // Write to disk
      await writeFile(resolvedPath, html, "utf-8");
  
      const violationCount = reviewData.accessibility.violations.length;
      const findingCount = reviewData.codeAnalysis.findings.length;
      const totalIssues = violationCount + findingCount;
  
      return {
        content: [
          {
            type: "text" as const,
            text: [
              `# UIMax Report Exported`,
              ``,
              `**File:** ${resolvedPath}`,
              `**URL:** ${url}`,
              `**Timestamp:** ${reviewData.timestamp}`,
              ``,
              `## Summary`,
              `- Accessibility violations: ${violationCount}`,
              `- Code findings: ${findingCount}`,
              `- Total issues: ${totalIssues}`,

• src/server.ts:139-150 (registration)

  Tool registration for export_report with its description and input schema.

    server.tool(
      "export_report",
      `Generate a standalone HTML report file with all audit findings embedded. Runs the full review pipeline (screenshot, accessibility, performance, code analysis) and outputs a beautiful, shareable HTML file with zero external dependencies.
  
  Use this when the user wants a downloadable/shareable report of their UI review.
  
  This tool is FREE — runs entirely within Claude Code.`,
      {
        url: z.string().url().describe("URL of the running application (e.g., http://localhost:3000)"),
        codeDirectory: z.string().describe("Absolute path to the frontend source directory (e.g., /Users/me/project/src)"),
        outputPath: z.string().optional().describe("Output file path for the HTML report (defaults to ./uimax-report.html)"),
      },