aurum-mcp

Kommuniziere mit dem Aurum Design System über deinen LLM-Client. Komponenten · Tokens · Icons · Figma-Node-IDs · Changelog — alles abfragbar von Claude Code, Cursor, Copilot CLI, Gemini und Claude Desktop.

aurum-mcp ist ein Model Context Protocol-Server, der den Aurum Design-System-Katalog für LLMs zugänglich macht. Er liest ein gebündeltes JSON-Manifest (automatisch synchronisiert von changejarapp.github.io/aurum-android) und stellt 9 Tools bereit, die das LLM aufrufen kann, um Fragen zu beantworten wie:

• „Zeig mir, wie man AurumChip verwendet.“

• „Welches Farb-Token haben wir für Text bei negativem Feedback?“

• „Was ist die Figma-Node für AurumTopAppBar?“

• „Gib mir das Icon für einen Zurück-Pfeil.“

• „Was hat sich im letzten Release geändert?“

Installation (einmal kopieren, für jeden Client)

Wähle unten deinen Client aus, füge den Schnipsel in die entsprechende Konfigurationsdatei ein und starte den Client neu.

Claude Code (.mcp.json im Projekt-Root oder ~/.claude.json)

{
  "mcpServers": {
    "aurum": {
      "command": "npx",
      "args": ["-y", "github:atri-jar/aurum-mcp#latest-stable"]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "aurum": {
      "command": "npx",
      "args": ["-y", "github:atri-jar/aurum-mcp#latest-stable"]
    }
  }
}

Copilot CLI (~/.copilot/mcp.json)

{
  "mcpServers": {
    "aurum": {
      "command": "npx",
      "args": ["-y", "github:atri-jar/aurum-mcp#latest-stable"]
    }
  }
}

Gemini CLI (~/.gemini/settings.json unter mcpServers)

{
  "mcpServers": {
    "aurum": {
      "command": "npx",
      "args": ["-y", "github:atri-jar/aurum-mcp#latest-stable"]
    }
  }
}

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)

Gleiches Format — füge den obigen Schnipsel in mcpServers ein. Starte die App neu.

Das war's. Keine npm-Registry, kein ~/.npmrc, kein PAT, keine Umgebungsvariablen. Öffentliches Git, öffentliches npx.

Versionierung

Der Standard-Schnipsel verwendet #latest-stable — ein CI-verwalteter Git-Tag, der immer auf das neueste stabile Release zeigt. Verhält sich wie das latest-Dist-Tag von npm: Du erhältst automatische Updates bei jedem neuen npx-Cache-Miss (ca. 10 Minuten bis einige Stunden, abhängig vom Cache deines Clients).

Für Reproduzierbarkeit — automatisierte Skripte, auditiertes Setup — pinne auf einen expliziten Tag:

"args": ["-y", "github:atri-jar/aurum-mcp#v0.1.0"]

Jede Version von aurum-mcp liefert das Manifest der passenden Aurum-Bibliotheksversion aus (@aurum-mcp:0.1.6 ⇄ aurum:0.1.6). Rufe get_aurum_version von deinem LLM-Client aus auf, um genau zu sehen, womit du kommunizierst.

Tools

Siehe docs/tools.md für vollständige Eingabeschemata und Beispielantworten.

Warum npx-von-Git und nicht npm?

Wir haben drei Distributionskanäle in Betracht gezogen (öffentliches npm, GitHub Packages, npx-von-Git) und uns für den dritten entschieden, da für ein internes Team-Tool, das auf Einfachheit, vollständige Kontrolle und null neue Infrastruktur optimiert ist, gilt:

• Keine neuen Konten zu verwalten. Keine npm-Organisation, kein NPM_TOKEN-Wechsel, keine 2FA-Wiederherstellung, keine Sorge um die 72-Stunden-Veröffentlichungsbeständigkeit. Das Repo IST das Artefakt, von Anfang bis Ende.

• Branch-basiertes Testen kostenlos. Möchtest du einen Feature-Branch ausprobieren? Ändere einfach den Schnipsel auf #feat/branch-name — fertig. Bei npm müsstest du ein Pre-Release-Tag veröffentlichen, das für immer in der Registry bleibt.

• Vorhandene Authentifizierung. Dieses Repo ist öffentlich; Teammitglieder haben GitHub-Zugriff; nichts Neues zu konfigurieren.

• Geringe Installationsverzögerung. Der erste Start dauert ca. 5–10 s für Klonen + Build gegenüber ca. 2–5 s bei npm. Zwischengespeicherte Starts sind identisch.

Kompromisse, die wir akzeptieren: weniger ausgefeilte UX beim Version-Pinning (Git-Tags vs. Semver-Bereiche) und keine Auffindbarkeit über öffentliches npm. Die vollständige Begründung findet sich in docs/architecture.md.

Lokale Entwicklung

git clone https://github.com/atri-jar/aurum-mcp.git
cd aurum-mcp
pnpm install
pnpm dev          # run the server via tsx + stdio
pnpm inspect      # spawn the official MCP Inspector UI
pnpm build        # tsc → dist/
pnpm smoke        # end-to-end tools/list + tools/call test

Der Server liest data/manifest.json (eingecheckt). Um das neueste Manifest aus der Live-Aurum-Galerie zu ziehen und die gebündelte Kopie zu aktualisieren:

make manifest-fetch

CI erledigt dies automatisch (siehe .github/workflows/sync-manifest.yml).

Architektur in einem Absatz

Das Aurum Design System liegt in Changejarapp/aurum-android (privat) und veröffentlicht eine öffentliche Galerie unter changejarapp.github.io/aurum-android. Das Skript tooling/gallery/generate.py aggregiert Komponenten, Tokens, Icons, Code-Connect-Mappings und das Changelog aus einem einzigen Satz von Parsern. Wir haben ein --emit-manifest-Flag hinzugefügt, das eine strukturierte JSON-Projektion derselben Daten erzeugt — der Vertrag ist tooling/manifest/schema.json in aurum-android. Dieser MCP-Server ist die Lese-Seite des JSON: Er lädt das Manifest beim Start, indiziert es und stellt die 9 oben genannten Tools bereit. Eine Quelle der Wahrheit, zwei Rendering-Ziele (HTML für Menschen, JSON für Agenten). Wenn aurum-ios erscheint, wird dessen Manifest als zusätzliche Quelle eingebunden — der MCP-Code ist plattformunabhängig.

Vollständiges Pipeline-Diagramm: docs/architecture.md.

Mitwirken

Issues und PRs sind willkommen. Siehe docs/contributing.md für den Workflow (Manifest-Sync, Drift-Check, Release-Prozess). Code-Stil: TypeScript strict, Prettier-Defaults; keine Geschäftslogik in Markdown-Formatern.

Lizenz

MIT — siehe LICENSE.