@uibeats/mcp

MCP server for UI Beats. Lets a coding agent search the component catalogue, read a component's full source and props, and install it, without anyone opening the website.

Install

Claude Code:

claude mcp add uibeats -- npx -y @uibeats/mcp

Cursor, Windsurf, Claude Desktop and anything else that reads an mcpServers block:

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

Tools

A typical exchange: the agent calls search_components("card that flips"), then get_component("flip-card") to read the real props before writing any JSX, then get_install_command("flip-card") and runs it.

How it works

There is no backend. The server is a cached client over two static files the site already publishes:

• /r/components.json: the search index (names, descriptions, props, guidance)
• /docs/<category>/<name>.md: the canonical document for one component

The catalogue is cached in memory for ten minutes, and a stale copy is kept as a fallback so a brief network failure does not break every tool call.

Configuration

UIBEATS_URL=http://localhost:3000 npx @uibeats/mcp

Development

This package is standalone: it is not part of the site's Yarn install.

cd packages/mcp
npm install
npm run build

License

MIT