Log inSubmit server
Starwind UI MCP Server logo

Starwind UI MCP Server

Framework-aware MCP tools for configuring, searching, documenting, and migrating Starwind UI v3 in Astro and React projects.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Starwind UI MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "starwind-ui-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@starwind-ui/mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 5 tools correctly (Today).

Overview

Starwind UI MCP Server MCP server provides framework-aware tools for Starwind UI v3 and Starwind Pro projects. It searches versioned component data, resolves documentation, generates initialization and installation commands, and produces v2-to-v3 migration guidance for Astro and React. The server validates catalog data from the Starwind manifest, caches it, and uses a bundled v3 snapshot if the site is unavailable. Reach for it when an AI client needs accurate Starwind UI setup or component guidance without executing commands directly.

Use cases

  • Initialize Starwind UI v3 in an existing Astro or React project
  • Search framework-specific components and primitives
  • Retrieve Runtime and migration documentation
  • Generate validated installation commands
  • Plan an interactive v2-to-v3 migration

Key features

  • Astro and React framework metadata
  • Styled component and primitive search
  • Validated initialization and add commands
  • Component, Runtime, and migration documentation lookup
  • Interactive-first v2-to-v3 migration guidance
  • Optional Starwind Pro support

Tools5

What Starwind UI MCP Server lets your agent do. Expand a tool for its parameters.

Verified live~896 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

8/8 checks healthy over the last 41d

What it can do

From the 5 tools this server returned when we ran it.

Read-only tools · 5
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age476 days
Maintainers1

Observed 2026-10-25 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 11d ago via OSV.dev · @starwind-ui/mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars35Stargazers on the source repository.
npm downloads1kPackage downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed5Callable tools this server registers over MCP.

How Starwind UI MCP Server works

What Starwind UI MCP Server MCP server does

Starwind UI MCP Server MCP server gives AI clients structured access to Starwind UI v3 and Starwind Pro information for Astro and React projects. Its tools cover project initialization, component and primitive discovery, documentation lookup, component installation command generation, and migration planning from v2 to v3.

The server keeps Starwind UI v3 surfaces separate. Styled components are copy-owned UI pieces with Astro and/or React implementations. Primitives are lower-level framework adapters, with some behavior backed by Starwind Runtime. Runtime APIs provide framework-neutral behavior documentation. This distinction affects which searches, installation commands, and documentation requests are valid.

How it works

The server checks requests and catalog information against Starwind UI's versioned ai-manifest.json. Validated data is cached for reuse. If the remote site cannot be reached, the server uses a bundled v3 snapshot instead.

Tool responses include readable JSON text and MCP structuredContent. Generated commands are returned for the client or developer to review; the server does not run them. Local project context and the package manager are detected when possible, and generated add commands pass the resolved package manager to the Starwind CLI.

starwind_init targets existing Astro 5+ or React 18+ projects and can detect the framework unless one is supplied. Node.js 22.12.0 or newer is required for the generated v3 CLI commands. Pro behavior is opt-in rather than enabled by default.

Setup and configuration

Install the server through an MCP client using the npm package command. Codex can define an MCP server whose command is npx with arguments -y and @starwind-ui/mcp. Claude Code and Cursor use the same command in their respective MCP JSON configuration files. Restart or reload the client after changing its configuration.

Starwind UI MCP Server MCP server does not execute initialization or installation output. Review the generated command and run it in the target project when appropriate. For paid Pro blocks, authorization is required. In an existing Astro project, the returned setup flow prepares the Pro registry and .env.local; the purchased STARWIND_LICENSE_KEY must replace the placeholder and remain out of source control, logs, and client-side code.

Tools and capabilities

  • starwind_init: Generates v3 initialization commands for an existing Astro or React project, with optional Pro setup.
  • starwind_add: Validates requests and creates installation or deferred-install commands for styled components, primitives, and Astro-only Pro blocks.
  • starwind_search: Finds styled components, primitives, and Pro blocks using framework metadata and filters.
  • starwind_docs: Retrieves exact component, primitive, Runtime, migration, and framework documentation.
  • starwind_migrate: Inspects a project and creates interactive-first v2-to-v3 migration guidance.

React searches exclude Pro blocks because those blocks currently target Astro. React add requests for Pro blocks are rejected. Free @starwind-pro/* catalog blocks can be installed after ordinary initialization, while paid blocks expose structured upgrade information and require explicit authorization.

Limitations and notes

Migration is interactive by default. Set yes: true only when backup-and-overwrite behavior is intended. The tools generate commands but do not execute them, so project changes remain under the developer's control. The server supports the Starwind UI v3 model and its documented Astro, React, Runtime, migration, and Pro distinctions; requests outside those surfaces may be rejected during validation.

The project is licensed under MIT. Development commands listed by the project include pnpm build, pnpm lint, and pnpm test:run.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Starwind UI MCP Server

Starwind UI MCP Server is an MCP server that connects AI clients to Starwind UI v3 and Starwind Pro guidance for Astro and React. Its main tools initialize projects, add components or primitives, search the catalog, retrieve documentation, and generate v2-to-v3 migration guidance without executing commands.

Install it through an MCP client with `npx -y @starwind-ui/mcp`. Codex uses a TOML MCP entry, while Claude Code and Cursor use JSON MCP configuration. Restart or reload the client after adding the server.

Yes, Starwind UI MCP Server works with Cursor through a `.cursor/mcp.json` entry that runs `npx -y @starwind-ui/mcp`. Reload Cursor's MCP servers after changing the configuration.

No, it generates and validates installation or deferred-install commands but does not execute them. Developers or their AI clients must review and run the returned command in the project.

No, React Pro blocks are not supported. Starwind Pro blocks currently target Astro, so React searches omit them and React add requests reject them explicitly.

Related MCP servers

All in Developer Tools All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewStarwind UI MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/starwind-ui-mcp-server?style=directory)](https://allmcps.com/mcp/starwind-ui-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/starwind-ui-mcp-server"><img src="https://allmcps.com/api/badge/starwind-ui-mcp-server?style=directory" alt="Starwind UI MCP Server on AllMCPs" /></a>