Starwind UI MCP Server

Ein TypeScript Model Context Protocol Server für Starwind UI v3 und Starwind Pro. Er bietet KI-Clients aktuelle, framework-bewusste Anleitungen für Astro- und React-Projekte.

Schnellstart

Eine Anleitung zur Einrichtung für verwaltete Clients findest du in der Starwind UI MCP-Dokumentation.

Codex (~/.codex/config.toml):

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

Claude Code (.mcp.json) oder Cursor (.cursor/mcp.json):

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

Starte den Client neu oder lade seine MCP-Server nach der Konfigurationsänderung neu.

Related MCP server: shadcn-ui MCP Server

v3-Modell

Starwind UI v3 hat drei zusammenhängende Oberflächen. Der MCP hält sie getrennt:

Der Server validiert diese Ebenen gegen die versionierte ai-manifest.json, speichert validierte Daten zwischen und greift auf eine gebündelte v3-Snapshot zurück, falls die Website nicht verfügbar ist.

Werkzeuge

Werkzeugaufrufe geben sowohl lesbaren JSON-Text als auch MCP structuredContent zurück.

Anforderungen und Verhalten

• Generierte v3-CLI-Befehle erfordern Node.js 22.12.0 oder neuer.

• starwind_init zielt auf bestehende Astro 5+- oder React 18+-Projekte ab und lässt die CLI das Framework automatisch erkennen, sofern nicht framework angegeben wird.

• Kostenlose @starwind-pro/*-Katalogblöcke funktionieren nach normaler Initialisierung. Kostenpflichtige Blöcke erfordern eine explizite Autorisierung; übergib pro: true nur, wenn dies erforderlich ist.

• Starwind Pro-Blöcke zielen derzeit auf Astro ab. React-Suchen lassen sie aus, und React-Add-Anfragen lehnen sie explizit ab.

• Die Migration ist standardmäßig interaktiv. Setze yes: true nur, wenn ein Backup-und-Überschreiben-Verhalten beabsichtigt ist.

• Paketmanager- und Projektkontext werden nach Möglichkeit lokal erkannt, und Add-Befehle übergeben den aufgelösten Paketmanager an die CLI. Kein Werkzeug führt den generierten Befehl aus.

Upgrade von kostenlos auf Pro

Der MCP hält Pro auffindbar, ohne eine kostenpflichtige Einrichtung zu erzwingen. Suchergebnisse verlinken zum Pro-Katalog, kostenlose Pro-Blöcke bleiben direkt installierbar, und kostenpflichtige Ergebnisse enthalten einen strukturierten proUpgrade-Pfad mit Kauf- und Installationslinks.

Für ein bestehendes Astro-Projekt empfiehlt der MCP:

pnpm dlx starwind@latest setup --yes

Der Einrichtungsbefehl erkennt den Paketmanager des Projekts automatisch, daher benötigt er kein --package-manager-Flag. Er bereitet das Pro-Register und .env.local vor; ersetze den Platzhalter STARWIND_LICENSE_KEY durch den gekauften Schlüssel und führe dann den zurückgegebenen deferredCommand aus. Behandle den Schlüssel als sensibel: halte .env.local aus der Versionskontrolle heraus und lege den Schlüssel niemals in Logs oder clientseitigem Code offen. Ein mit pro: true initialisiertes Projekt erhält stattdessen den entsprechenden Befehl init --pro.

Entwicklung

pnpm build
pnpm lint
pnpm test:run

Führe den optionalen Produktions-Manifest-Kontrolltest aus mit:

RUN_LIVE_CONTRACT_TESTS=1 pnpm test:run src/utils/starwind_live_contract.test.ts

Lizenz

MIT. Siehe LICENSE.

Sicherheit