uiverse-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| UIVERSE_CACHE_PATH | No | Custom cache path for the galaxy repo (default: ~/.uiverse-mcp/cache). Override with env var UIVERSE_CACHE_PATH. | ~/.uiverse-mcp/cache |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_categoriesA | List all Uiverse component categories with their component counts. Categories: Buttons, Cards, Checkboxes, Forms, Inputs, Notifications, Patterns, Radio-buttons, Toggle-switches, Tooltips, loaders. Call this first when you don't know what's available. |
| list_componentsA | List components in a specific category with pagination. Returns summaries only (id, author, name, tags, preview_url) — no HTML payload. Call get_component to fetch actual HTML/CSS for a specific component. Optional: filter by author. |
| search_componentsA | Fuzzy search components by name, tags, or author. Returns top matches as summaries (no HTML). Use this when the user asks for a specific style like 'glowing button', 'glass card', 'ripple loader'. Optional category filter narrows the search. |
| get_componentA | Fetch the full HTML + CSS of a specific component by category + id. Returns markup, CSS (or note if Tailwind-based), tags, author, preview URL. Use after browsing with list_components or search_components. |
| get_component_previewA | Return the public uiverse.io URL for visual preview of a component. Open this in a browser to see the component rendered with animations. Does NOT fetch HTML — use get_component for code. |
| refresh_cacheA | Pull the latest commits from the uiverse-io/galaxy repo and rebuild the in-memory index. Use when you suspect the cache is stale (last sync > 1 week). Returns commit SHA delta and new total count. |
| cache_statusA | Report cache metadata: last sync time, current commit SHA, total components indexed, per-category counts. Use to debug sync issues. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool has a clear, distinct purpose: listing categories, listing/searching components, fetching full component code, fetching preview URLs, and managing cache state. No overlap or ambiguity exists between tools.
All tool names follow a consistent snake_case verb_noun pattern (list_categories, list_components, search_components, get_component, get_component_preview, refresh_cache, cache_status). The naming is predictable and readable.
Seven tools is well-scoped for a component library MCP server. The five component-related tools plus two cache-management tools cover the domain without bloat or thinness.
The tool surface covers the full workflow: discover categories, list components, search by style, fetch component code, and preview visually. Cache refresh and status tools handle maintenance edge cases. No obvious gaps in the stated purpose.