wunderui-mcp 0.0.0-stage → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +74 -2
- package/data/DESIGN.md +4949 -0
- package/data/design.json +3622 -0
- package/package.json +49 -4
- package/src/index.mjs +388 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 WunderUI
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,75 @@
|
|
|
1
|
-
#
|
|
1
|
+
# WunderUI MCP
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
An MCP server that gives an AI coding agent the [WunderUI](https://wunderui.com) 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.
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
claude mcp add wunderui -- npx -y wunderui-mcp
|
|
7
|
+
```
|
|
8
|
+
|
|
9
|
+
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.
|
|
10
|
+
|
|
11
|
+
## Tools
|
|
12
|
+
|
|
13
|
+
| Tool | What the agent gets |
|
|
14
|
+
| --- | --- |
|
|
15
|
+
| `list_components` | The inventory, filterable by category, plan (free or pro) or free text |
|
|
16
|
+
| `get_component` | Exports, the TypeScript prop signature, the import line, an example, the docs URL |
|
|
17
|
+
| `get_tokens` | Light and dark tokens as JSON, a CSS block, or Tailwind `@theme` mappings |
|
|
18
|
+
| `get_design_md` | The full DESIGN.md, or one section (`rules`, `donts`, `tasks`, `tokens`, `inventory`, `reference`, `templates`, `starters`) |
|
|
19
|
+
| `list_templates` | The full-page templates and what each is built from |
|
|
20
|
+
| `get_starter` | Copy-paste TSX: app shell, dashboard, data grid, AI chat, theming |
|
|
21
|
+
| `get_library_info` | Package name, version, install commands, stack, counts, data source |
|
|
22
|
+
|
|
23
|
+
Every component carries its plan. On the Free plan, an agent should only use components marked `free`; the others need WunderUI Core or Pro.
|
|
24
|
+
|
|
25
|
+
## Install
|
|
26
|
+
|
|
27
|
+
**Claude Code**
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
claude mcp add wunderui -- npx -y wunderui-mcp
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
**Cursor**: `.cursor/mcp.json`
|
|
34
|
+
|
|
35
|
+
```json
|
|
36
|
+
{
|
|
37
|
+
"mcpServers": {
|
|
38
|
+
"wunderui": { "command": "npx", "args": ["-y", "wunderui-mcp"] }
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
**Windsurf, Cline, Codex, VS Code**: the same shape, in that editor's MCP config.
|
|
44
|
+
|
|
45
|
+
## Where the data comes from
|
|
46
|
+
|
|
47
|
+
`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.
|
|
48
|
+
|
|
49
|
+
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.
|
|
50
|
+
|
|
51
|
+
| Variable | Effect |
|
|
52
|
+
| --- | --- |
|
|
53
|
+
| `WUNDERUI_OFFLINE=1` | never touch the network, use the bundled copy |
|
|
54
|
+
| `WUNDERUI_SITE=<url>` | fetch the live data from another origin |
|
|
55
|
+
|
|
56
|
+
## Without MCP
|
|
57
|
+
|
|
58
|
+
The same data is served as static files for agents and editors that don't speak MCP:
|
|
59
|
+
|
|
60
|
+
- `https://wunderui.com/DESIGN.md`: paste at the top of a prompt
|
|
61
|
+
- `https://wunderui.com/llms.txt`: the llms.txt convention
|
|
62
|
+
- `https://wunderui.com/design.json`: the same structured index
|
|
63
|
+
|
|
64
|
+
## Verify
|
|
65
|
+
|
|
66
|
+
```bash
|
|
67
|
+
npm install
|
|
68
|
+
npm run smoke
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
Starts the server with a real MCP client and calls every tool once.
|
|
72
|
+
|
|
73
|
+
## Licence
|
|
74
|
+
|
|
75
|
+
The server code is MIT. The WunderUI components it describes are licensed per plan, see [wunderui.com/pricing](https://wunderui.com/#pricing).
|