@vaneui/mcp
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@vaneui/mcp what's the default appearance and variant of Chip?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@vaneui/mcp
A Model Context Protocol server that exposes the VaneUI documentation to AI coding agents. Any MCP-aware client (Claude Code, Claude Desktop, Cursor, VS Code, etc.) can search the docs and read the section that answers the question, so your agent writes correct VaneUI code without you pasting rules into prompts by hand.
It serves the full component reference, getting-started and customization guides, and a structured prop table for every component, through three tools: search_docs, get_doc and get_component_props.
Requirements
Node.js 20 or later (the
npxcommand below downloads and runs the server for you).
Related MCP server: rubyui-mcp
Quickstart
The server runs over stdio and is published to npm as @vaneui/mcp. Add it to your client with the snippets below; no local clone or build is needed.
Claude Code
claude mcp add vaneui -- npx -y @vaneui/mcpClaude Desktop
Edit your claude_desktop_config.json:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"vaneui": {
"command": "npx",
"args": ["-y", "@vaneui/mcp"]
}
}
}Restart Claude Desktop afterward.
Cursor
Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project):
{
"mcpServers": {
"vaneui": {
"command": "npx",
"args": ["-y", "@vaneui/mcp"]
}
}
}VS Code
code --add-mcp '{"name":"vaneui","command":"npx","args":["-y","@vaneui/mcp"]}'Or add to .vscode/mcp.json (note VS Code uses the servers key):
{
"servers": {
"vaneui": {
"command": "npx",
"args": ["-y", "@vaneui/mcp"]
}
}
}Other clients
Any client that accepts a stdio MCP server works. Use npx as the command and -y @vaneui/mcp as the args, following that client's config format.
How to use it
Once the server is connected, just build with VaneUI in natural language. The agent pulls the right docs through the tools automatically:
"Using VaneUI, build a pricing card with a title, a feature list, and a filled primary button." → the agent reads
card,list, andbuttonprops and composes them correctly."What's the default appearance and variant of
Chip?" →get_component_propsreturns the prop table (Chip defaults tosecondary+outline, notprimary)."How do I set app-wide defaults for every Button?" →
search_docsfinds thethemeDefaultssections of the theming guides, andget_docreads the one that shows theThemeProvider themeDefaultspattern."Does
Modaltrap focus, and can I turn that off?" →search_docspoints at the "Accessibility and advanced props" section of the Modal page, andget_docreturns it with thefocusTrapprop and its default."Which VaneUI prop maps to
flex-1?" →search_docsfinds it in the prop-to-Tailwind mapping.
Verifying it works
After adding the server and restarting your client:
The client should list a server named
vaneuiwith the toolssearch_docs,get_docandget_component_props(and thevaneui://docs/*resources).To smoke-test the server directly, run
npx -y @vaneui/mcpin a terminal. It starts and waits on stdio (no output is normal for an MCP stdio server; press Ctrl+C to exit).
Tools
A typical lookup takes two calls: search_docs to find the section, then get_doc to read it. get_component_props answers "which boolean props does this component take" in one call.
search_docs
Ranked search across the full doc corpus. The results are doc sections, best first.
Param | Type | Notes |
| string | Required. A few words ( |
| boolean | Optional. If |
| integer | Optional. Most sections to return, 1 to 50. Defaults to 10. |
The query is split into words, and common words such as "how" and "the" are ignored. A section that holds every word comes before a section that holds some of them. Within each group a word counts most in the section's heading, then in the page title, then in the text, and rare words count more than common ones. The words do not have to appear together or in order, and a plain word also finds its other forms (trap finds "trapping").
The first content block is a JSON array of sections:
[
{
"uri": "vaneui://docs/modal",
"slug": "modal",
"section": "accessibility-and-advanced-props",
"heading": "Accessibility and advanced props",
"lineNumber": 368,
"snippet": "| `focusTrap` | `true` | Trap `Tab` / `Shift+Tab` focus inside the modal |"
}
]slug and section are what get_doc takes. lineNumber and snippet show the best matching line of the section (the line's number in the page). A list holds at most 3 sections of one page, so one long page cannot fill it. When more sections matched than were returned, a second content block says so (Showing the best 3 of 88 matching sections ...). Use this before guessing prop names, defaults, or class mappings: the answer is almost always already in the docs.
get_doc
Reads a docs page, or one section of it. The other two tools return snippets and boolean props, so this is the tool that returns the text of the docs: value props such as Modal's open and onClose, sub-components and code examples.
Param | Type | Notes |
| string | Required. The page slug, e.g. |
| string | Optional. A section id from the page's section list or from a |
With only slug it returns the page's intro and the list of its sections, not the whole page:
# Modal
vaneui://docs/modal (slug "modal")
Import: import { Modal } from "@vaneui/ui"
Since: 0.9.0
Use Modal when the user has to finish or dismiss a task before returning to the page, ...
Sections (call get_doc again with one of these ids as `section`):
- basic-usage: Basic usage
- compound-modal: Compound Modal
...
- accessibility-and-advanced-props: Accessibility and advanced propsWith section it returns that section in full, with its subsections and code examples. Section ids are the heading anchors of the page on vaneui.com.
The slug is matched loosely, so the forms a model meets all work: a component name (IconButton), a file name (icon-button.md), a docs link (/docs/basic-components/icon-button) or a resource URI (vaneui://docs/icon-button). A docs link with a #fragment opens that section. An unknown page or section is a tool error that names the closest matches and lists what exists:
get_doc failed: No VaneUI doc "ModalHeader". Did you mean: modal? Pages: ai-assistants, alert, badge, ...get_component_props
Returns a component's boolean props as plain text, one line per category, with the default marked *. Props in one category are alternatives. The data comes from @vaneui/ui's ComponentCategories, ComponentKeys, defaultTheme, and PropDescriptions.
Param | Type | Notes |
| string | Required. The component slug, matching the resource basename, e.g. |
|
| Optional. Defaults to |
The shared layout props (display, gap, justify, border, width and the rest) are the same on most components, so compact output leaves them out: it lists the component's own props, then names the shared categories the component takes and its shared defaults. Call it with slug: "common" once to get those props. full adds a description to every prop and lists the shared props too.
card boolean props. Props in one category are alternatives; * marks the default. Descriptions: call again with detail "full".
Size: xs sm md* lg xl
Appearance: primary* accent secondary tertiary success danger warning info inheritAppearance
Variant: filled outline* ghost
...
Shared layout props (get_component_props "common" lists them): Hide, Show, Items, Justify, ...
Shared defaults: flex gap column border responsiveSizingProps that take a value, such as Field's label or Modal's title, are not boolean category props: read them on the component's page with get_doc and the same slug.
Available resources
Each documentation file is also exposed as a resource named vaneui://docs/<slug>, where <slug> is the lowercased source filename minus the .md extension. All resources have mimeType: text/markdown. A resource is the whole page. Clients without resource support read the same pages through get_doc.
Examples:
vaneui://docs/claude: VaneUI overview (component inventory, the boolean prop system, key defaults, package exports).vaneui://docs/component-usage,vaneui://docs/prop-to-tailwind-mapping: the usage guide (component selection, patterns, anti-patterns) and the prop-to-Tailwind class mapping.vaneui://docs/installation,vaneui://docs/usage-basics,vaneui://docs/core-concepts,vaneui://docs/nextjs,vaneui://docs/ai-assistants: getting-started guides.vaneui://docs/theming-overview,vaneui://docs/using-theme-provider,vaneui://docs/theme-defaults,vaneui://docs/theme-and-override,vaneui://docs/extra-classes,vaneui://docs/customizing-styles,vaneui://docs/variant-inheritance,vaneui://docs/css-variables,vaneui://docs/dark-mode: customization guides.vaneui://docs/common-props: shared layout/typography prop reference.vaneui://docs/button,vaneui://docs/card,vaneui://docs/modal, ...: one per component.
The corpus holds what helps a project that uses VaneUI. The rule files the vaneui repo keeps for work on the library itself (component internals, CSS conventions, tests, playground) are not part of it.
Development
This section is for contributors and maintainers working on the server itself.
Sources
The doc corpus is bundled from two sibling repos at build time:
vaneui/(a checkout of vaneui/vaneui) — the consumer-facing parts of its agent files: an allow-list of.claude/rules/*.mdfiles and ofCLAUDE.mdsections.vaneui-web/(a checkout of vaneui/web) — narrative guides and per-component reference, authored as plain markdown underapp/docs/data/**/*.md(one file per component, with frontmatter).
Each .md file goes into resources/ keyed by its basename (filenames are globally unique, so the corpus is flat).
The vaneui repo's CLAUDE.md and .claude/rules/ are written for people and agents who work on the library itself, and most of that (the verification pipeline, the release policy, test and playground conventions, theme internals) would steer an agent in a project that only uses VaneUI. So the sync ships an allow-list, kept in scripts/consumer-docs.ts: the rule files named in CONSUMER_RULE_FILES are copied verbatim, and CLAUDE.md keeps only the ## sections named in CONSUMER_CLAUDE_SECTIONS. A new rule file or section stays out of the corpus until it is added there; the sync log names what it left out, and the strict sync fails when an allow-listed file or section is gone (renamed upstream). test/sync.test.ts checks the filter and the committed corpus: it fails when resources/claude.md holds a section, or resources/ a vaneui rule file, that is not on the list.
vaneui-web/ pages are written with their {% include "x.md" %} tags expanded through vaneui-web's own include helper (lib/docs/includes.mjs), so each resource matches the page on vaneui.com. Files and directories whose name starts with _ are partials that pages include, so they get no resource of their own. scripts/sync-component-props.ts additionally reads each component's componentKey frontmatter and joins it with @vaneui/ui's exported metadata to produce resources/component-props.json. It marks a prop as shared (isCommon) when its category is in vaneui-web/app/docs/commonCategories.ts, the same split the props tables on vaneui.com use.
Building
Everything in this repo is TypeScript. src/ compiles to dist/, which is what the npm package ships. The sync scripts in scripts/ and the tests in test/ are .ts files that Node 24 runs directly (type stripping), so they need no build step.
The published server is plain JavaScript and runs on Node 20 and later (engines.node). Working on this repo (the sync scripts and the tests) needs Node 24, which is also what CI uses.
resources/ is committed to git, so a fresh clone already has everything the server needs to run.
npm install
npm run build # compile src/ to dist/ (tsconfig.build.json), using the committed resources/
npm run typecheck # type-check src/, scripts/ and test/ (tsconfig.json)
npm start # run the built server over stdioPoint a client at the local build with node /absolute/path/to/vaneui-mcp/dist/server.js as the command.
Testing
npm test compiles src/, type-checks the whole repo and runs the tests in test/ with node --test against the compiled dist/ and the committed resources/. They cover search ranking, page parsing, the three tools through a real MCP client (in memory and over stdio against dist/server.js), the sync allow-list and the declared Node range.
.github/workflows/test.yml runs npm ci and npm test on every pull request and on pushes to main.
Re-syncing the corpus (maintainers)
.github/workflows/sync-corpus.yml re-syncs the corpus once a day (and on manual dispatch) from vaneui/vaneui at prod (the released library) and vaneui/web at main (the deployed docs). It runs the strict sync and the tests, and when resources/ changed it opens one pull request from the chore/sync-corpus branch, or updates the open one. Review that the diff is content drift only, then merge. It needs the repository setting Settings → Actions → General → Workflow permissions → "Allow GitHub Actions to create and approve pull requests". Checks do not start by themselves on a pull request that GitHub Actions opened: close and reopen it to run them (the workflow has already run the tests on that corpus).
To re-sync by hand, the sync scripts expect vaneui/ and vaneui-web/ as sibling folders of this repo (resolved as ../vaneui and ../vaneui-web). Override with VANEUI_PATH / VANEUI_WEB_PATH env vars if they live elsewhere. Build vaneui/ first (npm ci && npm run build), because the prop table is read from its dist/, and run npm install in vaneui-web/, because its include helper loads @vaneui/md from there. A missing or cyclic include stops the sync.
npm run build:full # re-sync resources/ from the sibling repos, then buildnpm run sync— lenient sync: copies the allow-listed vaneui material and every docs page intoresources/and writescomponent-props.json. ⚠️ Wipesresources/first; if a sibling repo is missing you'll get a partial bundle. Preferbuild:full.npm run sync:strict— strict sync: exits non-zero if any sibling repo is missing, no MD files are found, or an allow-listed rule file orCLAUDE.mdsection is gone. Used byprepublishOnlyand by the sync workflow.
Adding or updating a doc
Edit (or create) the source markdown in
vaneui/orvaneui-web/:Component reference:
vaneui-web/app/docs/data/<category>/<slug>.md(with frontmatter).Narrative guide:
vaneui-web/app/docs/data/{getting-started,customization,reference}/.Usage rule:
vaneui/.claude/rules/<slug>.md. A new file ships only after its name is added toCONSUMER_RULE_FILESinscripts/consumer-docs.ts; a newCLAUDE.mdsection only after its title is added toCONSUMER_CLAUDE_SECTIONS.
npm run build:fullto regenerateresources/and recompile, or wait for the sync workflow's pull request.Commit the regenerated
resources/alongside the source edit, and restart your MCP client.
Record anything a user of the server will notice in CHANGELOG.md.
src/resources.ts reads the resources directory at startup, so no registry edit is needed when adding a file.
License
Available Tools
3 toolsget_component_propsA
Return a VaneUI component's boolean props, one line per category, default marked *. By default (compact) it lists the component's own props and names the shared layout categories it takes; slug common lists those once. detail full adds descriptions and every shared prop. Value props such as label or title are on the component's page: call get_doc with the same slug. The slug is the resource basename: button, card, icon-button, etc.
Inputs: slug (required), detail.
get_docA
Read a VaneUI docs page. With only slug it returns the page's intro and the list of its sections; with section it returns that section in full, code examples included. Call search_docs first when you do not know which page or section holds the answer: each of its results has the slug and section to pass here. Component pages (button, modal, field, ...) hold what get_component_props does not list: value props such as open and onClose or label and error, sub-components and examples.
Inputs: slug (required), section.
search_docsA
Search the VaneUI docs (component pages, guides, usage rules, prop-to-Tailwind mapping). Give a few words or an exact name such as themeDefaults. Results are doc sections, best first: sections that hold every word come before sections that hold some, and a word in a heading or page title counts more than one in the text. Returns a JSON array of up to limit sections, each with slug, section, heading, lineNumber and a short snippet, and says when more sections matched than were returned. Pass a result's slug and section to get_doc to read that section. Use this before guessing prop names, defaults, or class mappings.
Inputs: query (required), limit, regex.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
search_docs (find), get_doc (read a page/section) and get_component_props (boolean prop tables) have distinct roles, and the descriptions explicitly cross-reference each other to steer selection. The only real overlap is between get_component_props and a component page read via get_doc, which is mitigated by clear guidance that value props live on the page.
All three tools use consistent snake_case verb_noun form (search_docs, get_doc, get_component_props). The verb choice (search vs. get) mirrors the read-vs-lookup distinction, so names are predictable and readable.
Three tools is lean but each earns its place for a docs server: search, read, and prop lookup cover the core loop. It sits at the low end of the ideal range, but nothing feels redundant.
Search, section reading, code examples, and prop tables give solid coverage of the docs domain, with search serving as the entry point for unknown slugs. The notable gap is the absence of a list_docs/list_components tool, forcing agents to search blindly to enumerate pages.
Maintenance
Related MCP Connectors
Versioned documentation registry and semantic search for AI tools and coding assistants.
Search and read Vector Panda docs: API operations, pricing, storage tiers, measured benchmarks.
Provide your AI coding tools with token-efficient access to up-to-date technical documentation for…
Tailor Platform for AI assistants: search, list and read the platform documentation.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to access documentation of Vue UI components, including props, events, and slots, for generating correct usage code.7MIT
- AlicenseNot gradedqualityDmaintenanceProvides AI assistants with access to RubyUI component library documentation, including listing components, fetching docs, searching, and getting installation/theming guides.GPL 3.0
- AlicenseAqualityDmaintenanceEnables AI assistants to search and retrieve documentation, component specs, theme guides, and CLI commands for the Meta Astryx Design System, providing structured tools and guidelines for coding agents.4MIT
- FlicenseAqualityCmaintenanceEnables AI clients to search live documentation for popular developer libraries and return clean, source-cited summaries via a RAG pipeline.1-