Starwind UI MCP Server

by starwind-ui

35 1.2k downloads Not rated yet MIT

GitHub Website

About

Give AI the full power of Starwind UI - setup new projects, add components, get documentation, search blocks, and more

Details

License: MIT

Explore

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Starwind UI MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

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:

``toml title="~/.codex/config.toml" [mcp_servers.starwind_ui] command = "npx" args = ["-y", "@starwind-ui/mcp"] enabled = true



Claude Code:

json title=".mcp.json"

{

  "mcpServers": {

    "starwind-ui": {

      "command": "npx",

      "args": ["-y", "@starwind-ui/mcp"],

      "env": {}

    }

  }

}



Cursor:
json title=".cursor/mcp.json"

{

  "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
Use starwind_init for new projects. For new projects that need Pro blocks, the generated command uses:

bash

starwind@latest init --defaults --pro



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

starwind@latest setup --yes

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

`starwind_init`

Generates a Starwind UI v3 initialization command for an existing Astro or React project. The CLI auto-detects the framework unless an override is provided. Paid Pro authorization is opt-in and currently targets Astro.

`starwind_add`

Generates validated Starwind UI v3 install commands for styled components, vendored primitives, or Starwind Pro blocks, with optional Astro or React targeting.

`starwind_search`

Searches Starwind UI v3 styled components, Primitive adapters, and Starwind Pro blocks with framework-aware results.

`starwind_docs`

Fetches current Starwind UI v3 documentation across styled components, primitives, Runtime, migration, and Astro or React framework guides.

`starwind_migrate`

Generates the safe Starwind UI v3 migration command for a legacy Astro project. Interactive migration is the default; non-interactive overwrite behavior must be explicitly requested.

| 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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

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.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Explore

Setting up with Highlight

From the repository

starwind_init

starwind_add

starwind_search

starwind_docs

starwind_migrate

Claude Desktop / Cursor

McpServers

What is MCP?

More like this

Sequential Thinking

Sentry

Github

Filesystem

`starwind_init`

`starwind_add`

`starwind_search`

`starwind_docs`

`starwind_migrate`