Starwind Ui Mcp

A TypeScript implementation of a Model Context Protocol (MCP) server for Starwind UI and Starwind Pro, providing tools to help developers work with Starwind UI and Pro components when leveraging AI tools like Codex, Claude Code, and Cursor.

Quick Start

Select your MCP client and add the Starwind UI server configuration. For the full maintained setup guide, see the Starwind UI MCP Server docs.

Codex:

[mcp_servers.starwind_ui]
command = "npx"
args = ["-y", "@starwind-ui/mcp"]
enabled = true

Claude Code:

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

Cursor:

{
  "mcpServers": {
    "starwind-ui": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@starwind-ui/mcp"],
      "env": {}
    }
  }
}

After adding the configuration, restart your editor or reload its MCP servers.

Detailed client instructions:

• Starwind UI MCP Server docs
• Codex MCP docs
• Claude Code MCP docs
• Cursor MCP docs

Available Tools

The MCP server intentionally keeps a compact, intent-based tool surface. It does not expose standalone wrappers for every Starwind CLI command, such as setup, update, or remove.

Starwind Pro Setup

Use starwind_init for new projects. For new projects that need Pro blocks, the generated command uses:

starwind@latest init --defaults --pro

For an already initialized Starwind UI project, use the Pro setup guidance returned by starwind_add or starwind_search:

starwind@latest setup --yes

starwind_search returns grouped standard component and Pro block results, with Pro block filters for plan, category, limit, and offset.

What is MCP?

The Model Context Protocol (MCP) is a protocol for extending AI capabilities through local servers. This implementation provides Starwind UI-specific tools to enhance AI assistant capabilities when working with Starwind UI. For more information about MCP itself, please visit the official documentation.

Features

• Live Documentation - Fetches up-to-date docs from starwind.dev/llms.txt
• Component Validation - Validates components against live component metadata with a refreshed fallback list
• Starwind Search - Search and discover standard components and Pro blocks by query, category, plan, limit, or offset
• Compact Tool Surface - Keeps uncommon or destructive CLI operations as command guidance instead of standalone MCP tools
• Package Manager Detection - Auto-detects npm, yarn, or pnpm
• Caching & Rate Limiting - Efficient caching with sensible rate limits
• TypeScript - Built with TypeScript for type safety

License

MIT License - See LICENSE file for details.

Security