WunderUI

io.github.Kl-webmedia由 GitHub 账号 Kl-webmedia 发布v1.2.1更新于 Nov 3, 2026

The WunderUI design system for coding agents: components, props, tokens, rules and skills.

已验证STDIO仅桌面知识与记忆开发者工具

概览

AI 生成的概览

为编码助手提供 WunderUI React 设计系统:组件清单、真实 props 签名、设计令牌、页面模板、起始代码与技能。

可以做什么
  • 按分类、套餐或关键词筛选组件清单,并查看单个组件的导出、TypeScript props、结构与 CSS 变量
  • 以 JSON、CSS 或 Tailwind 主题映射形式读取明暗两套设计令牌,以及完整设计文档和简短常驻规则
  • 列出整页模板,并获取应用外壳、仪表盘、数据表格、AI 对话或主题化的可复制 TSX 起始代码
  • 列出代理技能并获取某个技能的说明,以及获取 UI 区块的 React 源码及其共享辅助代码
适用场景
适合助手使用 WunderUI 构建 React 界面时,复用已有组件与令牌而不是自行拼写标记。也适用于从其他组件库迁移,或希望在不粘贴文档的情况下让设计规则直接出现在编辑器里。
运行要求
以 stdio 在本地运行,通常通过 npx 启动 wunderui-mcp 这个 npm 包,因此需要 Node.js。免费内容无需账号或密钥。可选环境变量:WUNDERUI_LICENSE_KEY 用于 Pro 技能与区块源码,WUNDERUI_OFFLINE 用于离线,WUNDERUI_SITE 用于更换数据来源。会联网从 wunderui.com 刷新设计数据。
安装前请注意
该服务器只描述组件库,并不安装它;实际 React 包需另行安装。Pro 技能与区块源码需要在 WUNDERUI_LICENSE_KEY 中提供 WunderUI Pro 密钥,该密钥会发送至 wunderui.com。默认情况下服务器会在后台从 wunderui.com 获取更新的设计数据;可设置 WUNDERUI_OFFLINE 避免联网。免费套餐用户应只使用标记为 free 的组件。

安装

在 SourceWeft 中

  1. 打开 控制台中的 WunderUI,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

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.

bash
claude mcp add wunderui -- npx -y wunderui-mcp

Works 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

ToolWhat the agent gets
list_componentsThe inventory, filterable by category, plan (free or pro) or free text
get_componentExports, the TypeScript prop signature, the import line, an example, the docs URL
get_tokensLight and dark tokens as JSON, a CSS block, or Tailwind @theme mappings
get_design_mdThe full DESIGN.md, or one section (rules, donts, tasks, tokens, inventory, reference, templates, starters)
list_templatesThe full-page templates and what each is built from
get_starterCopy-paste TSX: app shell, dashboard, data grid, AI chat, theming
get_library_infoPackage name, version, install commands, stack, counts, data source
get_instructionsThe short, always-on rules (components, tokens, motion, copy) for CLAUDE.md / AGENTS.md
list_skillsThe WunderUI agent skills, free and Pro
get_skillOne skill's instructions (SKILL.md), so the agent can follow it without installing — Pro skills need WUNDERUI_LICENSE_KEY
get_block_sourceThe 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.

Resources

Clients that support MCP resources can attach the design context without a tool call. Read-only, and the same data as the tools above:

Resource URIWhat it holds
wunderui://design-mdThe full DESIGN.md (markdown)
wunderui://design-jsonThe machine-readable design data (tokens, inventory, templates, skills)
wunderui://tokensLight and dark token values
wunderui://instructionsThe short rules for CLAUDE.md / AGENTS.md
wunderui://componentsThe component inventory: name, category, plan, description
wunderui://components/{slug}One component in full (one resource per component, listed by the server)

The tools stay for clients without resource support.

Install

Claude Code

bash
claude mcp add wunderui -- npx -y wunderui-mcp

Cursor: .cursor/mcp.json

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.

VariableEffect
WUNDERUI_OFFLINE=1never 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 prompt
  • https://wunderui.com/llms.txt: the llms.txt convention
  • https://wunderui.com/design.json: the same structured index

Verify

bash
npm installnpm run smoke

Starts the server with a real MCP client and calls every tool once.

Releasing

  1. Bump the version in package.json and in server.json (top-level version and packages[0].version — the workflow refuses to publish when they differ).
  2. Commit, tag vX.Y.Z and push the tag. The Publish to npm workflow publishes to npm (Trusted Publishing) and then publishes server.json to the MCP Registry with GitHub OIDC — no tokens.
  3. If the registry ever falls behind npm, run the workflow by hand (Actions → Publish to npm → Run workflow) with registry_only ticked; it publishes the current server.json for a version that already exists on npm.

Licence

The server code is MIT. The WunderUI components it describes are licensed per plan, see wunderui.com/pricing.

来源:README.md,提交 17381f2

工具

11

list_components

List WunderUI components

The WunderUI component inventory: name, category, plan (free or pro) and one-line description. Filter by category, plan or a free-text query. Call this first to find out whether a component already exists before building one by hand. On the Free plan use only components with plan "free".

输入参数planquerycategory

get_component

Get a WunderUI component

Everything needed to use one component correctly: its exported names, the TypeScript prop signature straight from the build, a props table per export (type, allowed values, default, required, description), its anatomy (parts and data-slot names), best practices, the CSS variables it reads with their defaults, the import line and a link to its documentation page. Also answers for hooks (signature, parameters, return value, notes), providers and utilities (useToast, ThemeProvider …).

输入参数name必填

get_tokens

Get WunderUI design tokens

The design tokens for light and dark, in the format you need. Use these instead of hardcoding colours; overriding them is how WunderUI is themed.

输入参数themeformat

get_design_md

Get the WunderUI DESIGN.md

The complete design context as one markdown document: install steps, the rules an agent should follow, every token, the component inventory with props, and starter snippets. Pull this once at the start of a build.

输入参数section

list_templates

List WunderUI page templates

Full pages assembled only from WunderUI components — a dashboard, a settings page, an AI inbox and a sign-in screen. Start from one of these instead of an empty file.

无需输入参数。

get_starter

Get a WunderUI starter snippet

Copy-paste TSX for a common composition, wired with the correct props: an application shell, a dashboard row, a data grid, an AI chat, or the theming pattern.

输入参数kind必填

get_library_info

Get WunderUI package info

Package name and version, install commands, the stack it is built on, and how many components, categories and templates exist.

无需输入参数。

get_instructions

Get the short WunderUI rules

The short, always-on rules for building with WunderUI (components, tokens, motion, copy) — the text to keep in CLAUDE.md / AGENTS.md. Read this first; use get_design_md for the full context.

无需输入参数。

list_skills

List WunderUI agent skills

The agent skills that build and check with WunderUI (set up a project, build screens, theme from a brand colour, migrate from shadcn/MUI/Chakra, token check, motion and accessibility audits, Figma). Free skills work for everyone; Pro skills need WUNDERUI_LICENSE_KEY.

无需输入参数。

get_skill

Get a WunderUI agent skill

Returns one skill's instructions (its SKILL.md) from wunderui.com, so the agent can follow the workflow without installing the skill. Pro skills are sent only with a valid Pro key in WUNDERUI_LICENSE_KEY. Scripts the skill mentions come with the installed skill (wunderui.com/skills).

输入参数name必填

get_block_source

Get a WunderUI block's source (Pro)

The React source of a UI block (e.g. category 'app', block 'billing'), optionally one screen, plus the shared helpers it imports. Needs a WunderUI Pro key in WUNDERUI_LICENSE_KEY. Use https://wunderui.com/api/registry/index to see every block.

输入参数block必填screencategory必填

版本历史

2
  1. v1.2.1最新Nov 1, 2026
  2. v1.1.0Oct 10, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分