Superdesign MCP Server

Instructions

Implementation Reference

• dist/index.js:2134-2171 (handler)

  Handler function for superdesign_list tool that lists design files in the superdesign/design_iterations and design_system directories, formats a text response with file lists.

  case "superdesign_list": {
      const { workspace_path } = ListDesignsSchema.parse(args);
      try {
          const superdesignDir = getSuperdeignDirectory(workspace_path);
          const designIterationsDir = path.join(superdesignDir, 'design_iterations');
          const designSystemDir = path.join(superdesignDir, 'design_system');
          const designFiles = await glob('*.{html,svg}', { cwd: designIterationsDir });
          const systemFiles = await glob('*.json', { cwd: designSystemDir });
          let result = `Superdesign workspace: ${superdesignDir}\n\n`;
          if (designFiles.length > 0) {
              result += `Design iterations (${designFiles.length}):\n`;
              designFiles.forEach(file => {
                  result += `  - ${file}\n`;
              });
          }
          else {
              result += "No design iterations found.\n";
          }
          result += "\n";
          if (systemFiles.length > 0) {
              result += `Design systems (${systemFiles.length}):\n`;
              systemFiles.forEach(file => {
                  result += `  - ${file}\n`;
              });
          }
          else {
              result += "No design systems found.\n";
          }
          return {
              content: [{ type: "text", text: result }],
          };
      }
      catch (error) {
          return {
              content: [{ type: "text", text: `Error listing designs: ${error.message}` }],
          };
      }
  }

• dist/index.js:30-32 (schema)

  Zod schema for validating input parameters of the superdesign_list tool (workspace_path optional).

  const ListDesignsSchema = z.object({
      workspace_path: z.string().optional().describe("Workspace path (defaults to current directory)")
  });

• dist/index.js:1877-1886 (registration)

  Registration of the superdesign_list tool in the listTools response, including name, description, and input schema.

  {
      name: "superdesign_list",
      description: "List all created designs in the workspace",
      inputSchema: {
          type: "object",
          properties: {
              workspace_path: { type: "string", description: "Workspace path (defaults to current directory)" }
          },
      },
  },

• dist/index.js:59-74 (helper)

  Helper function to get or create the superdesign directory structure including design_iterations and design_system subdirectories.

  function getSuperdeignDirectory(workspacePath) {
      const basePath = workspacePath || process.cwd();
      const superdesignDir = path.join(basePath, 'superdesign');
      if (!existsSync(superdesignDir)) {
          mkdirSync(superdesignDir, { recursive: true });
      }
      const designIterationsDir = path.join(superdesignDir, 'design_iterations');
      if (!existsSync(designIterationsDir)) {
          mkdirSync(designIterationsDir, { recursive: true });
      }
      const designSystemDir = path.join(superdesignDir, 'design_system');
      if (!existsSync(designSystemDir)) {
          mkdirSync(designSystemDir, { recursive: true });
      }
      return superdesignDir;
  }