nifdi-Plugin

Das nifdi-Diagramm-Plugin: der @nifdi/mcp-Diagrammserver, gebündelt mit den Skills, die ihn lehren — das Modell im Detail, die Platzierungsgrammatik, ausgearbeitete Rezepte und die Build-Schleife, die dafür sorgt, dass das, was du baust, auch so aussieht, wie du es dir vorgestellt hast.

Der Server ist die Verb-Oberfläche. Die Skills sind das Handwerk. Sie werden als eine Einheit installiert.

Installation

claude plugin marketplace add nifdi-app/nifdi-plugin

claude plugin install nifdi@nifdi-plugin

Dies registriert dieses Repository als Marktplatz und installiert das Plugin: den nifdi-diagram MCP-Server (gestartet mit npx -y @nifdi/mcp@<pinned>) plus die Skills, die von deinem Client schrittweise geladen werden, wenn eine Aufgabe sie benötigt.

Unter Claude Code ist keine Verzeichniskonfiguration nötig – es injiziert das Projektstammverzeichnis, und Diagramme landen als .nifdi.svg-Dateien in dem Repository, an dem du arbeitest. Bei einem Client, der das nicht tut, setze NIFDI_ROOT auf den gewünschten Ordner.

Der Server allein, ohne die Lehrebene, bleibt wie bisher installierbar:

claude mcp add nifdi-diagram -s project -- npx -y @nifdi/mcp@latest

Was hier enthalten ist

.claude-plugin/plugin.json       the plugin: pins the server version, ships the skills
.claude-plugin/marketplace.json  the single-plugin marketplace
skills/nifdi/                    the core skill: the model, placement, styling, connectors, workflow
test/                            contract CI — every fenced example, through the pinned server

Die SKILL.md des Kern-Skills ist ein Index auf derselben Ebene wie die eigenen Anweisungen des Servers; die Details befinden sich in skills/nifdi/references/, die ein Client nur lädt, wenn der eingeschlagene Pfad sie benötigt.

Der nackte Server bleibt eigenständig

Skills sind optionaler Kontext – ein reiner MCP-Client sieht sie nie. Daher lebt nichts, was ein Agent für die korrekte Werkzeugnutzung benötigt, nur in einem Skill. Was hier lebt, ist die unbegrenzte Ebene: Model-Tiefenbohrungen, Rezepte, Stilbewertung, Provider-Konventionen. Der Vertrag – was jedes Werkzeug tut, akzeptiert und ablehnt – bleibt im Server und wird an jeden Client ausgeliefert.

Die Folgerung ist noch wichtiger: Ein Verhaltensfehler wird im Server behoben, niemals in einem Skill übertüncht. Ein Skill, der Agenten lehrt, einen defekten Befehl zu umgehen, verbirgt den Fehler vor jedem rohen MCP-Client. Siehe CONTRIBUTING.md.

Skills sind ebenfalls Verträge

Jedes eingerahmte Beispiel in jedem Skill wird von CI durch das veröffentlichte @nifdi/mcp ausgeführt – dieselbe Round-Trip-Disziplin, die der Server auf seine eigenen zitierten Beispiele anwendet, nun von außen angewendet. Ein Rezept, dessen XML nicht mehr geparst werden kann oder dessen behauptetes Ergebnis nicht mehr mit dem übereinstimmt, was das Werkzeug meldet, führt zu einem Build-Fehler.

Die Skills pinnen die Server-Version, gegen die sie getestet wurden, und das Manifest pint beide gemeinsam, sodass eine Installation ein kohärentes Paar ergibt. Ein geplanter Durchlauf testet die Skills auch gegen @nifdi/mcp@latest, sodass eine Server-Veröffentlichung, die ein Rezept ungültig macht, hier erkannt wird, anstatt von einem Agenten mitten im Diagramm entdeckt zu werden.

npm install && npm test

Um den Vertrag gegen einen Server-Build auszuführen, der sich nicht auf npm befindet – ein lokaler Checkout, ein Tarball, ein Release Candidate – setze NIFDI_MCP_SPEC darauf:

NIFDI_MCP_SPEC=../nifdi-app/mcp npm run test:examples

Status. @nifdi/mcp@0.1.1 – die Version, die dieses Repository pint – ist noch nicht auf npm veröffentlicht. Bis dahin können die obigen Installationsbefehle und der gepinnte CI-Job den Server nicht auflösen, und der Vertrag läuft nur über NIFDI_MCP_SPEC.

Mitwirken

Provider-Konventionen – wie ein gutes AWS-, Azure- oder GCP-Diagramm aussieht und welcher nifdi- Wortschatz es erzeugt – sind die wichtigste Beitragsoberfläche: wertvoll, abgegrenzt und ohne Zugang zu nifdi-Interna. CONTRIBUTING.md enthält die Anforderungen und die Anleitung zur lokalen Ausführung der Prüfungen.

Lizenz

Apache-2.0. Die nifdi-Anwendung selbst ist geschlossen; diese Lehrebene ist offen.