# Starwind UI MCP Server

Hands the agent current Starwind UI v3 knowledge: component search, install commands, docs and a v2-to-v3 migration path. Built for Astro and React work.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 35
- Author: starwind-ui
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/starwind-ui/starwind-ui-mcp
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/starwind-ui-mcp-server

## What it does

The TypeScript server treats Starwind UI v3 as three separate surfaces: styled components, primitives and Runtime. Component discovery and install go through `starwind_search` and `starwind_add`, reference material through `starwind_docs`, and `starwind_migrate` inspects a project before suggesting the move off v2.

Everything is validated against the versioned `ai-manifest.json` and cached. If the site is down, a bundled v3 snapshot takes over. The server writes the CLI command but never runs it; package manager and project context are picked up locally and passed along in the generated line.

Node.js 22.12.0 or newer is required for the commands it produces. `starwind_init` expects an existing Astro 5+ or React 18+ project. Pro blocks are Astro-only today — React searches leave them out, and React install requests get rejected. Paid blocks need authorization, so pass `pro: true` only when it is genuinely required.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp -- npx -y @starwind-ui/mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add starwind-ui-mcp-server -- npx -y @starwind-ui/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "starwind-ui-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@starwind-ui/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "starwind-ui-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@starwind-ui/mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add starwind-ui-mcp-server npx -y @starwind-ui/mcp
```

## When to use it
- find a component that matches your framework
- produce an install command for a component
- pull exact Runtime documentation
- plan a move from Starwind UI v2 to v3
- tell free Pro blocks from paid ones

## Example prompts
- Search Starwind UI for a card component for Astro and show me the install command
- Inspect my project and outline a Starwind UI v2 to v3 migration
- Fetch the Starwind UI Runtime docs

## Similar
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [tldraw](https://affpapa.org/en/nevibecode/mcp/tldraw.md) — MCP server · ★ 51091
- [Figma-Context-MCP](https://affpapa.org/en/nevibecode/mcp/figma-context-mcp.md) — MCP server · ★ 16062
- [mcp-server-chart](https://affpapa.org/en/nevibecode/mcp/mcp-server-chart.md) — MCP server · ★ 4402
- [Dembrandt](https://affpapa.org/en/nevibecode/mcp/dembrandt.md) — MCP server · ★ 3821
- [RevoGrid DataGrid MCP Pro](https://affpapa.org/en/nevibecode/mcp/revogrid-datagrid-mcp-pro.md) — MCP server · ★ 3450

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md