
Starwind UI
โ 35from starwind-ui
Provides tools to help developers work with Starwind UI components.
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.
Available Tools
| Tool Name | Description |
|---|---|
starwind_init | Generates init commands for new Starwind UI projects, Pro by default |
starwind_docs | Fetches live documentation from starwind.dev with caching and topic filtering |
starwind_add | Generates validated install commands with package manager detection |
starwind_search | Searches Starwind UI components and Starwind Pro blocks with CLI-shaped filters |
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.
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
Security
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 = trueClaude 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 Pro Setup
Use starwind_init for new projects. For new projects that need Pro blocks, the generated command uses:
starwind@latest init --defaults --proFor an already initialized Starwind UI project, use the Pro setup guidance returned by starwind_add or starwind_search:
starwind@latest setup --yesstarwind_search returns grouped standard component and Pro block results, with Pro block filters for plan, category, limit, and offset.
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
Licensed under MITโ you can use, modify, and redistribute it under that license's terms.
License
MIT License - See LICENSE file for details.
