its-just-ui MCP Server

Instructions

Implementation Reference

• src/index.ts:375-386 (handler)

  The tool handler for 'list_components' that parses the input schema, calls componentRegistry.listComponents(category), and returns the result as a JSON string in the tool response format.

  case "list_components": {
    const { category } = ListComponentsSchema.parse(args);
    const components = componentRegistry.listComponents(category);
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(components, null, 2),
        },
      ],
    };
  }

• src/index.ts:44-57 (schema)

  Zod schema defining the input for the 'list_components' tool: optional 'category' enum to filter components.

  const ListComponentsSchema = z.object({
    category: z
      .enum([
        "all",
        "core",
        "navigation",
        "form",
        "data-display",
        "feedback",
        "layout",
      ])
      .optional()
      .describe("Filter components by category"),
  });

• src/index.ts:159-180 (registration)

  Registration of the 'list_components' tool in the ListToolsRequestHandler response, providing name, description, and input schema.

    name: "list_components",
    description:
      "List available its-just-ui components and their categories",
    inputSchema: {
      type: "object",
      properties: {
        category: {
          type: "string",
          enum: [
            "all",
            "core",
            "navigation",
            "form",
            "data-display",
            "feedback",
            "layout",
          ],
          description: "Filter components by category",
        },
      },
    },
  },

• src/components/registry.ts:484-497 (helper)

  Core logic implementation in ComponentRegistry.listComponents that iterates over registered components, filters by optional category, and groups them by category name returning Record<string, string[]>.

  listComponents(category?: string): Record<string, string[]> {
    const result: Record<string, string[]> = {};
  
    for (const [name, info] of this.components) {
      if (!category || category === "all" || info.category === category) {
        if (!result[info.category]) {
          result[info.category] = [];
        }
        result[info.category].push(name);
      }
    }
  
    return result;
  }