Superdesign MCP Server

Instructions

Implementation Reference

• src/index.ts:66-73 (schema)

  Input schema definition for the superdesign_check_files tool

  const CheckFilesSchema = z.object({
    workspace_path: z.string().optional().describe("Workspace path (defaults to current directory)"),
    manifest: z.array(z.object({
      name: z.string(),
      size: z.number(),
      modified: z.number()
    })).describe("File manifest to compare against")
  });

• src/index.ts:2048-2069 (registration)

  Registration of the superdesign_check_files tool in the list of available tools

  name: "superdesign_check_files",
  description: "Check for file changes by comparing current files with a manifest (for gallery refresh integration)",
  inputSchema: {
    type: "object",
    properties: {
      workspace_path: { type: "string", description: "Workspace path (defaults to current directory)" },
      manifest: {
        type: "array",
        items: {
          type: "object",
          properties: {
            name: { type: "string" },
            size: { type: "number" },
            modified: { type: "number" }
          },
          required: ["name", "size", "modified"]
        },
        description: "File manifest to compare against"
      }
    },
    required: ["manifest"],
  },

• src/index.ts:2516-2539 (handler)

  Handler that processes superdesign_check_files tool calls: validates input with CheckFilesSchema, computes changes using checkFileChanges, returns JSON with hasChanges and changes list

  case "superdesign_check_files": {
    const { workspace_path, manifest } = CheckFilesSchema.parse(args);
    
    try {
      const superdesignDir = getSuperdeignDirectory(workspace_path);
      const designIterationsDir = path.join(superdesignDir, 'design_iterations');
      
      if (!existsSync(designIterationsDir)) {
        return {
          content: [{ type: "text", text: JSON.stringify({ hasChanges: false, changes: [], error: "No design iterations directory found" }) }],
        };
      }
      
      const result = checkFileChanges(superdesignDir, manifest);
      
      return {
        content: [{ type: "text", text: JSON.stringify(result) }],
      };
    } catch (error: any) {
      return {
        content: [{ type: "text", text: JSON.stringify({ hasChanges: false, changes: [], error: error.message }) }],
      };
    }
  }

• src/index.ts:298-331 (helper)

  Core logic that scans current design files (*.html, *.svg), compares against manifest by name/size/mtime, detects and categorizes changes as added/modified/deleted

  function checkFileChanges(superdesignDir: string, manifest: Array<{name: string; size: number; modified: number}>): {hasChanges: boolean; changes: Array<{file: string; type: 'added' | 'modified' | 'deleted'}>} {
    const designIterationsDir = path.join(superdesignDir, 'design_iterations');
    const currentFiles = glob.sync('*.{html,svg}', { cwd: designIterationsDir });
    const changes: Array<{file: string; type: 'added' | 'modified' | 'deleted'}> = [];
    
    // Check for new or modified files
    currentFiles.forEach(file => {
      const filePath = path.join(designIterationsDir, file);
      if (existsSync(filePath)) {
        const stats = statSync(filePath);
        const manifestEntry = manifest.find(m => m.name === file);
        
        if (!manifestEntry) {
          // New file
          changes.push({ file, type: 'added' });
        } else if (stats.size !== manifestEntry.size || stats.mtime.getTime() !== manifestEntry.modified) {
          // Modified file
          changes.push({ file, type: 'modified' });
        }
      }
    });
    
    // Check for deleted files
    manifest.forEach(manifestEntry => {
      if (!currentFiles.includes(manifestEntry.name)) {
        changes.push({ file: manifestEntry.name, type: 'deleted' });
      }
    });
    
    return {
      hasChanges: changes.length > 0,
      changes
    };
  }