Starwind UI MCP Server

What is Starwind UI MCP Server about?

A TypeScript‑based MCP server that extends AI assistants with Starwind UI‑specific capabilities. It offers tool‑based commands for initializing projects, managing components, fetching documentation, detecting the package manager, and retrieving LLM‑ready data from starwind.dev.

How to use Starwind UI MCP Server?

Run the server via npx (recommended):

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

Place the JSON in the configuration file required by your IDE (e.g., mcp.json, mcp_config.json, or .mcp.json).

Smithery installation (optional):

npx -y @smithery/cli install @starwind-ui/starwind-ui-mcp --client claude

Restart the AI assistant or IDE to let it discover the server.

Key features of Starwind UI MCP Server

Tool‑based architecture – modular commands such as init_project, install_component, update_component, get_documentation, fetch_llm_data, and get_package_manager.
Automatic package‑manager detection – works with npm, yarn, pnpm.
LLM data fetcher – pulls Starwind UI information with caching and rate‑limiting.
Documentation lookup – returns direct links to component guides.
Standard I/O transport – communicates via stdin/stdout, compatible with most AI tools.
TypeScript implementation – strong type safety and easy extensibility.

Use cases of Starwind UI MCP Server

AI‑assisted development – let Claude, Cursor, or Windsurf generate or modify Starwind UI code without leaving the editor.
Component management automation – automatically install or update UI components via AI prompts.
Rapid prototyping – initialize a new Starwind UI project from an AI conversation.
Documentation assistance – retrieve exact component docs on‑demand during coding sessions.
Custom tool extension – developers can add new tools to the server for specialized workflows.

FAQ from the Starwind UI MCP Server

Q: Which IDEs support this server?

Windsurf, Cursor, Claude Code, and any other tool that follows the MCP specification.

Q: Do I need a specific package manager?

The server detects npm, yarn, or pnpm automatically; no manual configuration is required.

Q: Is an API key required?

No API key is needed for the core server. Only the optional fetch_llm_data tool may require access to starwind.dev, which is rate‑limited and cached.

Q: Can I add my own tools?

Yes. Create a new file under src/tools/, register it in src/tools/index.ts, enable it in src/config/settings.ts, then rebuild with pnpm build.

Q: How do I build and run the server locally?

Clone the repo, run pnpm install, then pnpm build and pnpm start. The npx command handles this automatically for most users.

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

Quick Start

Using npx

Instructions to set up your IDE to use a local MCP server vary by IDE. Here are examples for different platforms:

Windsurf:

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

Cursor:

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

Claude Code:

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

Detailed instructions:

Installing via Smithery

To install Starwind UI MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @starwind-ui/starwind-ui-mcp --client claude

Available Tools

Tool Name	Description
`init_project`	Initializes a new Starwind UI project
`install_component`	Generates installation commands for Starwind UI components
`update_component`	Generates update commands for Starwind UI components
`get_documentation`	Returns documentation links for Starwind UI components and guides
`fetch_llm_data`	Fetches LLM data from starwind.dev (rate limited, with caching)
`get_package_manager`	Detects and returns the current package manager information

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

Tool-based Architecture - Modular design for easy addition of new tools
Starwind UI Documentation Tool - Access documentation links for Starwind UI components
Package Manager Detection - Detect and use the appropriate package manager (npm, yarn, pnpm)
LLM Data Fetcher - Retrieve Starwind UI information for LLMs with caching and rate limiting
TypeScript Implementation - Built with TypeScript for better type safety and developer experience
Standard I/O Transport - Uses stdio for communication with AI assistants

Development

This project is set up to use PNPM for package manager for development purposes. If you are not using pnpm, you will need to update the package.json file with the appropriate package manager commands you need.

Project Structure

src/
  ├── config/         # Server configuration
  │   └── settings.ts # Configuration settings
  ├── tools/          # MCP tools implementations
  │   ├── index.ts    # Tool registration
  │   └── *.ts        # Individual tool implementations
  ├── utils/          # Utility functions
  └── server.ts       # Main MCP server implementation

Adding New Tools

To add your own tools to the server:

Create a new tool file in the src/tools/ directory
Register the tool in src/tools/index.ts
Enable the tool in src/config/settings.ts
Rebuild the server with pnpm build
Restart the server with pnpm start

License

MIT License - See LICENSE file for details.

Starwind UI MCP Server