@vizejs/musea-mcp-server: Vue.js design system builder — 13 tools for component analysis, docs, variants
@vizejs/musea-mcp-server is a project-scanning MCP server for Vue.js design systems. 13 tools for component analysis, palette extraction, variant generation, CSF story generation, documentation, catalog generation, and design token management. Scans Vue SFCs in the working directory.
Package: npx musea-mcp (npm @vizejs/[email protected]) Server: musea-mcp-server/0.0.1-alpha.11 | Protocol 2024-11-05 | 2 capabilities: resources, tools Tools (13): analyzecomponent, getpalette, listcomponents, getcomponent, getvariant, searchcomponents, recommendcomponents, generatevariants, generatecsf, generatedocs, generatecatalog, gettokens, search_tokens
Version skew: npm 0.260.0 vs serverInfo 0.0.1-alpha.11. Clean empty-state behavior (returns [] when no components found). Token tools need tokens/ or design-tokens/ directory. Probed 3 runs, 100% protocol conformant, p50 init 84ms, p50 call 0-6ms.
Verified probe of @vizejs/[email protected] — 3/3 runs, 100% protocol conformant.
Setup: npm install @vizejs/[email protected] then node dist/cli.mjs Server: musea-mcp-server/0.0.1-alpha.11 | Protocol 2024-11-05 | Capabilities: resources, tools
Trace (run 1):
- initialize → OK (102ms), serverInfo: {name: "musea-mcp-server", version: "0.0.1-alpha.11"}
- tools/list → 13 tools: analyzecomponent, getpalette, listcomponents, getcomponent, getvariant, searchcomponents, recommendcomponents, generatevariants, generatecsf, generatedocs, generatecatalog, gettokens, search_tokens
- list_components({}) → 6ms — returns [] (empty state, no Vue project)
- search_components({query: "button"}) → 0ms — returns [] (empty state)
- analyze_component({}) → returns MCP error -32602: "Provide one of: path, title, component, query, or ref" (clean error handling)
- search_tokens({query: "color"}) → returns MCP error -32602: "No tokens path provided and none auto-detected" (clean error)
Performance: p50 init 84ms, p50 tool calls 0-6ms Nature: Project-scanning tool — works on existing Vue.js projects with .vue SFCs and optional design-tokens/ directory. Empty-state is well-handled. Version skew: npm publishes 0.260.0 but serverInfo reports 0.0.1-alpha.11. Gotchas: analyzecomponent/getpalette need at least one of: path, title, component, query, or ref. Token tools need a tokens/ or design-tokens/ directory. The bin entry is musea-mcp (cli.mjs), not index.mjs.
{ "tool": "list_components", "args": {}, "result_preview": "[] (empty state — needs Vue project with .vue SFCs)" }