base-ui-mcp

MCP server that gives AI assistants context about Base UI.

Install

Claude Code:

claude mcp add base-ui -- npx -y base-ui-mcp

Codex CLI:

codex mcp add base-ui -- npx -y base-ui-mcp

Or add to ~/.codex/config.toml (global) / .codex/config.toml (project):

[mcp_servers.base-ui]
command = "npx"
args = ["-y", "base-ui-mcp"]

Cursor — add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "base-ui": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "base-ui-mcp"]
    }
  }
}

VS Code — add to .vscode/mcp.json (workspace) or run MCP: Open User Configuration:

{
  "servers": {
    "base-ui": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "base-ui-mcp"]
    }
  }
}

opencode — add to opencode.json:

{
  "mcp": {
    "base-ui": {
      "type": "local",
      "command": ["npx", "-y", "base-ui-mcp"],
      "enabled": true
    }
  }
}

Prefer a different runner? Swap npx -y base-ui-mcp for:

| Runner | Command | |---|---| | npm | npx -y base-ui-mcp | | pnpm | pnpm dlx base-ui-mcp | | yarn | yarn dlx base-ui-mcp | | bun | bunx base-ui-mcp |

For JSON/TOML configs, split the runner into command + args (e.g. "command": "pnpm", "args": ["dlx", "base-ui-mcp"]).

Works with any MCP client via stdio.

Tools

| Tool | Purpose | |---|---| | list_components | List all Base UI components by category | | search_components | Keyword search | | get_component | Full docs for one component | | get_component_example | Extract code blocks by section/language | | get_install_instructions | Install command + import snippet | | get_handbook_guide | Fetch a handbook guide |

License

MIT