mcp-server-naiveui-docs

naiveui.com is a Vue SPA. web_fetch returns a shell with no prop tables. Training data invents APIs the pin never shipped. This stdio MCP clones tusen-ai/naive-ui at v2.40.4, indexes the markdown and demos, and answers lookups offline. It is not a Naive UI runtime.

Needs rustc 1.85+ (edition 2024), plus git, curl, and tar on PATH. HOME must be set. Do not point NAIVE_UI_MCP_CACHE at /tmp, /var/tmp, /dev/shm, or a world-writable path.

Install (for AI agents)

Four steps, in order. If you skip --sync, naive_status reports components: 0, pin_match: false, missing: ["naive-ui"]. Until the clone exists, only compiled gotchas are served.

1. Install the binary

cargo install --git https://github.com/codeChap/mcp-server-naiveui-docs
command -v mcp-server-naiveui-docs

That path is almost always $HOME/.cargo/bin/mcp-server-naiveui-docs. Copy it. MCP configs do not expand $HOME.

2. Clone and index the pin

mcp-server-naiveui-docs --sync

Network and disk writes. Checks out tusen-ai/naive-ui at v2.40.4 into ~/.cache/mcp-server-naiveui-docs/src/naive-ui. Success at this pin prints cloned at v2.40.4 then indexed 116 pages, 735 demos. Counts move if the pin changes.

Run this CLI sync before registering the server. NAIVE_UI_MCP_SYNC_ON_START=1 clones during MCP launch and makes the first start slow.

3. Register stdio server naiveui-docs

Server id is naiveui-docs. naive-ui is the Vue library. Paste the path from step 1, not a placeholder. Restart the client after writing config so tools load.

Grok (~/.grok/config.toml):

[mcp_servers.naiveui-docs]
command = "/home/you/.cargo/bin/mcp-server-naiveui-docs"
args = []
enabled = true
startup_timeout_sec = 60

Claude / Cursor (mcp.json or Claude desktop config):

{
  "mcpServers": {
    "naiveui-docs": {
      "command": "/home/you/.cargo/bin/mcp-server-naiveui-docs"
    }
  }
}

4. Confirm the catalog, then look things up

Call naive_status. Healthy means pin_match is true, missing is [], and components is greater than 0. At this pin that is components: 95, pages: 116, demos: 735, docs: 20, origin: "git". Extra keys (cache, git_head, gotchas, schema_version, built_at) are normal.

If the catalog is empty, call MCP naive_sync. force=true wipes the clone first. Then follow the playbook. Do not invent Naive props from training data. Do not web_fetch naiveui.com.

Playbook

Same text as ServerHandler::get_info instructions:

1. Unknown component? naive_search(query) then naive_component(name).
2. Known tag (n-data-table, n-select)? naive_component directly; ids accept n-data-table, NDataTable, data-table.
3. Looking for a prop across the lib (remote, pagination)? naive_prop(name).
4. Need a usage snippet? naive_component demos list, then naive_demo(component, name). On-disk files are *.demo.vue / *.demo.md, not the fence's basic.vue.
5. Toasts / confirms / loading bar outside setup: naive_discrete first. StackChap: createDiscreteApi once; window.$message / $dialog / $notification.
6. Theme tokens / --n-* CSS vars: naive_theme(component?).
7. Prose guides and gotchas: naive_get(id) (docs/customize-theme, gotchas). Component ids: use naive_component, not naive_get.
8. Empty catalog / pin_match false: naive_sync.

Templates use kebab tags (n-select). setup() / h() uses Pascal (NButton) from window.naive in IIFE apps. Prefer Naive over homemade dropdowns, tables, dialogs.

Remote paging on a table, as a worked lookup:

1. naive_prop with

... View full README on GitHub