# VaneUI

> VaneUI is a free MCP server for developer tools. Give coding agents VaneUI component docs and prop tables so they write valid props. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI
- **Website:** https://vaneui.com
- **Repository:** https://github.com/vaneui/mcp
- **MCP Registry name:** io.github.vaneui/mcp
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

VaneUI is a React component library on Tailwind CSS v4 where size, colour, variant and shape are boolean props, so you write Button with primary, lg and filled instead of variant strings. The MCP server exists so an agent does not guess those prop names.

Two tools do the work. search_docs runs a case-insensitive substring or regex search across the documentation and returns up to 50 hits with the resource URI, slug, line number and a snippet. get_component_props returns a component's boolean props as plain text, one line per category, with the default marked, so an agent can learn for instance that Chip defaults to secondary and outline. The full component reference, getting-started and customisation guides are also served as vaneui://docs resources.

It runs locally over stdio through npx and needs Node.js 24. Setup snippets are given for Claude Code, Claude Desktop, Cursor and VS Code.

## Features

- **Prop table lookup:** Returns each component's boolean props by category with defaults marked.
- **Documentation search:** Substring or regex search that returns up to 50 hits with snippets.
- **Docs as resources:** Serves the component reference and guides as vaneui://docs resources.
- **Local stdio server:** Runs through npx with no clone or build step.
- **Multi-client setup:** Config examples for Claude Code, Claude Desktop, Cursor and VS Code.

## Good for

- Build a sign-in form with Field and Button using correct props
- Check the default appearance and variant of a component
- Find how to set app-wide theme defaults
- Look up which prop maps to a Tailwind class

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp -- npx -y @vaneui/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@vaneui/mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@vaneui/mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@vaneui/mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@vaneui/mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@vaneui/mcp"
      ]
    }
  }
}
```

## Tools

- `search_docs`: Substring or regex search across the VaneUI docs.
- `get_component_props`: Boolean prop table for a component with defaults marked.

## FAQ

### What does it need to run?

Node.js 24; npx downloads and runs the package @vaneui/mcp.

### Which tools does it expose?

search_docs and get_component_props, plus vaneui://docs resources.

### Does it need credentials?

No environment variables are required.

### How do I add it to Claude Code?

Run claude mcp add vaneui -- npx -y @vaneui/mcp.

### Is VaneUI free?

Yes. VaneUI is free to use.

### How do I add VaneUI to Claude Code?

Run this command in your terminal: claude mcp add mcp -- npx -y @vaneui/mcp

### What are the best alternatives to VaneUI?

The closest alternatives to VaneUI are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/vaneui
