WunderUI
The WunderUI design system for coding agents: components, props, tokens, rules and skills.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
wunderui-mcpclaude mcp add wunderui -- npx -y wunderui-mcp@1.1.0{
"mcpServers": {
"wunderui": {
"command": "npx",
"args": [
"-y",
"wunderui-mcp@1.1.0"
]
}
}
}Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
WunderUI MCP
An MCP server that gives an AI coding agent the WunderUI design system: design tokens, the component inventory with real prop signatures, page templates and starter snippets. The agent builds with the library instead of reinventing a data grid out of raw divs.
claude mcp add wunderui -- npx -y wunderui-mcpWorks with Claude Code, Cursor, Windsurf, Cline, Codex, VS Code and any other client that speaks MCP over stdio. No key and no account needed.
Tools
| Tool | What the agent gets |
|---|---|
list_components | The inventory, filterable by category, plan (free or pro) or free text |
get_component | Exports, the TypeScript prop signature, the import line, an example, the docs URL |
get_tokens | Light and dark tokens as JSON, a CSS block, or Tailwind @theme mappings |
get_design_md | The full DESIGN.md, or one section (rules, donts, tasks, tokens, inventory, reference, templates, starters) |
list_templates | The full-page templates and what each is built from |
get_starter | Copy-paste TSX: app shell, dashboard, data grid, AI chat, theming |
get_library_info | Package name, version, install commands, stack, counts, data source |
get_instructions | The short, always-on rules (components, tokens, motion, copy) for CLAUDE.md / AGENTS.md |
list_skills | The WunderUI agent skills, free and Pro |
get_skill | One skill's instructions (SKILL.md), so the agent can follow it without installing — Pro skills need WUNDERUI_LICENSE_KEY |
get_block_source | The React source of a UI block and its shared helpers — needs a Pro key in WUNDERUI_LICENSE_KEY |
Every component carries its plan. On the Free plan, an agent should only use components marked free; the others need WunderUI Core or Pro.
Install
Claude Code
claude mcp add wunderui -- npx -y wunderui-mcpCursor: .cursor/mcp.json
{
"mcpServers": {
"wunderui": { "command": "npx", "args": ["-y", "wunderui-mcp"] }
}
}Windsurf, Cline, Codex, VS Code: the same shape, in that editor's MCP config.
Installing WunderUI itself
The server describes the library; it does not ship it. @wunderui/react on npm is WunderUI Free (the free components only). Core and Pro licence holders install the full library from the wunderui-core download (the wunderui-setup agent skill does it for you), and the server tells agents exactly that.
Where the data comes from
data/design.json and data/DESIGN.md are generated from the WunderUI source with every release: tokens from the stylesheet, props from the built type definitions, names and descriptions from the docs.
The server starts with the bundled copy and answers immediately. In the background it fetches the current design.json and DESIGN.md from wunderui.com and switches to them when they are at least as new, so agents see new components without a package update. get_library_info reports which source is in use.
| Variable | Effect |
|---|---|
WUNDERUI_OFFLINE=1 | never touch the network, use the bundled copy |
WUNDERUI_SITE=<url> | fetch the live data from another origin |
WUNDERUI_LICENSE_KEY=<key> | your WunderUI Pro key — unlocks Pro skills (get_skill) and block source (get_block_source); sent only to wunderui.com |
Without MCP
The same data is served as static files for agents and editors that don't speak MCP:
https://wunderui.com/DESIGN.md: paste at the top of a prompthttps://wunderui.com/llms.txt: the llms.txt conventionhttps://wunderui.com/design.json: the same structured index
Verify
npm install
npm run smokeStarts the server with a real MCP client and calls every tool once.
Licence
The server code is MIT. The WunderUI components it describes are licensed per plan, see wunderui.com/pricing.
Questions fréquentes
Qu'est-ce que WunderUI ?
The WunderUI design system for coding agents: components, props, tokens, rules and skills.
Comment installer WunderUI ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add wunderui -- npx -y wunderui-mcp@1.1.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour WunderUI ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
WunderUI est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient WunderUI ?
Il est publié par Kl-webmedia. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.