Was ist adrkit MCP?
adrkit behandelt Architecture Decision Records (ADRs, kurze Dokumente, die eine Designentscheidung und ihre Begründung festhalten) als typisierte Daten: Markdown-Dateien in git mit YAML-Frontmatter, einem Status wie accepted, rejected oder superseded und einem affects-Feld, das jede Entscheidung mit Pfaden oder Paketen verknüpft. Das Paket @adrkit/mcp ist ein lokaler stdio-Server, mit dem ein Agent diesen Bestand durchsuchen, einen Eintrag abrufen, die für eine Reihe von Dateien geltenden Entscheidungen auflisten und das Ersetzte auflisten kann.
Das Projekt stammt von Mark Beacom (GitHub-Nutzer mbeacom), steht unter Apache-2.0 und ist in TypeScript für Node 22 oder neuer geschrieben. Im offiziellen MCP-Registry ist es als dev.adrkit/mcp gelistet. Version 0.20.0 erschien am 11. Oktober 2026; das Repository hatte 24 Sterne, der letzte Push war am 7. November. Dasselbe Monorepo liefert eine CLI, eine GitHub Action, die geltende Entscheidungen als Kommentar in Pull Requests schreibt, und ein Plugin für Claude Code und Copilot.
adrkit MCP installieren
npx -y @adrkit/mcp --cwd /path/to/repo --dir docs/adrLohnt sich adrkit MCP?
Der Kern des adrkit-Servers ist der Friedhof. list_superseded und der Verlaufsabschnitt von get_decision_context liefern verworfene und ersetzte Entscheidungen neben den angenommenen, sodass ein Agent, der eine Änderung an src/db/ plant, sieht, dass MySQL ausprobiert und ersetzt wurde, bevor er MySQL erneut vorschlägt. Allgemeine Memory-Server speichern, was ein Agent speichern wollte; dieser liest Einträge, die Menschen geprüft und gemergt haben.
Die Oberfläche besteht aus vier Tools, alle als nur lesend und Closed World annotiert: search_decisions (wörtliche Teilstring-Suche über id, Titel, Tags und Text), get_decision, get_decision_context für bis zu 256 repository-relative Dateien und list_superseded. get_decision_context vergleicht Pfade mit den affects-Mustern jedes Eintrags und öffnet die Dateien nie. Ergebnisse werden standardmäßig in Seiten zu 20 und höchstens 100 ausgegeben, und Einträge über 64 KiB werden mit einem Befund ausgeschlossen statt gekürzt. Das hält die Kontextkosten klein und vorhersehbar.
Der Haken: Der Nutzen hängt vollständig an einem Bestand, den die meisten Teams nicht haben. Einträge brauchen das Frontmatter von adrkit und für die Dateizuordnung ein gepflegtes affects-Feld; adr migrate --from madr ergänzt das in einem vorhandenen MADR-Bestand, aber die Muster muss trotzdem jemand schreiben. Das Projekt ist vor 1.0, und das eigene README bittet darum, eine Version festzulegen. Die Suche ist wörtliche Teilstring-Suche, bewusst ohne Ranking oder Embeddings, also muss der Agent die Wörter erraten, die ein Eintrag verwendet. Das Agenten-Plugin liefert absichtlich keine MCP-Konfiguration mit, weil Copilot CLI Plugin-Server außerhalb des Repositorys startet, daher bindet jedes Projekt den Server selbst ein.
Bei der Sicherheit ist das ungefähr so eng, wie ein MCP-Server sein kann. Er liest Markdown unter einem Verzeichnis in einem einzigen git-Worktree, weist Ausbrüche über Symlinks ab, macht keine Modell- oder Netzwerkaufrufe, öffnet keinen Port und schreibt nichts. Die Angriffsfläche für Prompt-Injection sind die Texte der Einträge selbst, die jeder ändern kann, der ins Repository mergen darf. Der separate REST-Server im Container-Image ist etwas anderes: Er authentifiziert niemanden, und das README warnt, dass jeder, der seinen Port erreicht, alle damit bereitgestellten Bestände lesen kann.
Wo es sich lohnt
Ein Plattformteam aus acht Leuten mit 60 ADRs in docs/adr
Verhindern, dass der Coding-Agent das Queue-System erneut vorschlägt, das das Team letztes Jahr verworfen hat
Trage den Server in die .vscode/mcp.json des Projekts oder die Claude-Konfiguration ein und weise den Agenten an, vor dem Planen get_decision_context auf den Dateien aufzurufen. Der verworfene Eintrag erscheint im Verlauf. Kostenlos; ein migrate-Lauf und einige affects-Muster sind zu schreiben.
Eine Staff Engineer, die einen vom Agenten geschriebenen Plan prüft
Prüfen, welche angenommenen Entscheidungen eine geplante Änderung berührt
Lass den Agenten die Dateien auflisten, die der Plan ändert, und get_decision_context aufrufen, dann get_decision für jeden geltenden Eintrag, um dessen Vorgaben zu zitieren. Passt zur GitHub Action, die dieselbe Antwort im Pull Request postet.
Eine Beratung, die die Codebasis eines Kunden mit MADR-Dateien übernimmt
Agenten die Entscheidungshistorie des Kunden geben, ohne eine Wissensdatenbank aufzubauen
Führe adr migrate --from madr aus, um das adrkit-Frontmatter direkt zu ergänzen, und richte adrkit-mcp mit --cwd auf das Repository. Die ursprünglichen MADR-Werkzeuge funktionieren weiter, weil das Schema eine Obermenge ist.
Bevor du dich festlegst
- Einrichtung
- npx -y @adrkit/mcp --cwd /path/to/repo --dir docs/adr auf Node 22+, oder das Image ghcr.io/mbeacom/adrkit mit mcp und einem schreibgeschützten Mount. Die README-Konfigurationen decken Claude Desktop, VS Code, Cursor und GitHub Copilot CLI ab. --cwd muss die Wurzel eines git-Worktrees sein.
- Integrationen
- Vier nur lesende Tools: search_decisions, get_decision, get_decision_context und list_superseded. Spricht die MCP-Protokollrevisionen von 2025 und 2026-07-28 über stdio. Das Gesamtprojekt ergänzt eine CLI, eine Action für Pull Requests, eine Spec-Kit-Erweiterung und ein Agenten-Plugin.
- Daten und Datenschutz
- Liest Markdown-Einträge unter einem ADR-Verzeichnis in einem Repository, mit realpath-Prüfungen gegen Ausbrüche über Symlinks. Keine Schreibzugriffe, Modellaufrufe, Netzwerkzugriffe oder dauerhaften Indizes, und kein Port. Der Agent vertraut dem Text der Einträge, also behandle Merge-Rechte für docs/adr entsprechend. Der separate REST-Server im Container hat keine Authentifizierung.
- Kosten im großen Maßstab
- Kostenlos unter Apache-2.0. Jeder tools/call lädt den Bestand neu, die Kosten sind also lokale Dateizugriffe; Ausgabeseiten enden bei 100 Einträgen.
- Grenzen
- Rund 12 offene Issues. Nur wörtliche Suche; Ersetzungen werden nur einen Schritt weit verfolgt; föderierte log:id-Verweise werden erkannt, aber nie aufgelöst; ein Bestand pro Server; Plugin-Hosts von Copilot CLI können ihn nicht starten.
Was gut ist
- Zeigt verworfene und ersetzte Entscheidungen
- Vier nur lesende Tools; kein Netzwerk, kein Modell, keine Schreibzugriffe
- Ordnet Dateien per Muster den geltenden Entscheidungen zu
- Begrenzte, paginierte Ausgabe hält den Kontext klein
Was nicht
- Nutzlos ohne ADR-Bestand im adrkit-Format
- Nur wörtliche Teilstring-Suche, kein Ranking
- Vor 1.0; das Projekt rät, Versionen festzulegen
- Jedes Projekt muss den Server selbst einbinden
Am besten für
Teams, die Architecture Decision Records bereits in git führen und wollen, dass Coding-Agenten sie prüfen, bevor sie ein Design vorschlagen.
Alternativen zu adrkit MCP
adrkit MCP: häufige Fragen
- Lohnt sich adrkit MCP?
- Ein kleiner, streng nur lesender Server, der eine Sache gut macht, nämlich einen Agenten von einem Weg abzuhalten, den das Team schon verworfen hat, vorausgesetzt, deine Entscheidungen liegen im Format von adrkit vor. Wir bewerten es mit 3.6 von 5.
- Was kostet adrkit MCP?
- Kostenlos und quelloffen (Apache-2.0; das Schema ist zusätzlich CC0). Kein gehosteter Dienst, kein Bezahltarif.
- Welche Nachteile hat adrkit MCP?
- Nutzlos ohne ADR-Bestand im adrkit-Format; Nur wörtliche Teilstring-Suche, kein Ranking; Vor 1.0; das Projekt rät, Versionen festzulegen; Jedes Projekt muss den Server selbst einbinden.
- Für wen eignet sich adrkit MCP?
- Teams, die Architecture Decision Records bereits in git führen und wollen, dass Coding-Agenten sie prüfen, bevor sie ein Design vorschlagen.
- Was kostet adrkit MCP für ein Team oder im Produktivbetrieb?
- Kostenlos unter Apache-2.0. Jeder tools/call lädt den Bestand neu, die Kosten sind also lokale Dateizugriffe; Ausgabeseiten enden bei 100 Einträgen.
- Ist adrkit MCP sicher für Firmendaten?
- Liest Markdown-Einträge unter einem ADR-Verzeichnis in einem Repository, mit realpath-Prüfungen gegen Ausbrüche über Symlinks. Keine Schreibzugriffe, Modellaufrufe, Netzwerkzugriffe oder dauerhaften Indizes, und kein Port. Der Agent vertraut dem Text der Einträge, also behandle Merge-Rechte für docs/adr entsprechend. Der separate REST-Server im Container hat keine Authentifizierung.
- Was sind die besten Alternativen zu adrkit MCP?
- Die nächsten Alternativen, die wir getestet haben, sind MCP Memory Keeper, Memory (reference server) und codebase-memory-mcp.
Antworten geprüft am 11. Nov. 2026.