Qu’est-ce que adrkit MCP ?
adrkit traite les architecture decision records (ADR, de courts documents qui consignent un choix de conception et sa raison) comme des données typées : des fichiers Markdown dans git avec un frontmatter YAML, un statut comme accepted, rejected ou superseded, et un champ affects qui relie chaque décision à des chemins ou des paquets. Son paquet @adrkit/mcp est un serveur stdio local qui permet à un agent de chercher dans ce corpus, de récupérer un enregistrement, de lister les décisions qui régissent un ensemble de fichiers et de lister ce qui a été remplacé.
Le projet est de Mark Beacom (utilisateur GitHub mbeacom), sous licence Apache-2.0 et écrit en TypeScript pour Node 22 ou ultérieur. Il figure dans le registre officiel MCP sous le nom dev.adrkit/mcp. La version 0.20.0 est sortie le 11 octobre 2026 ; le dépôt comptait 24 étoiles et son dernier push datait du 7 novembre. Le même monorepo fournit une CLI, une GitHub Action qui commente dans les pull requests les décisions applicables, et un plugin pour Claude Code et Copilot.
Installer adrkit MCP
npx -y @adrkit/mcp --cwd /path/to/repo --dir docs/adradrkit MCP vaut-il le coup ?
L'intérêt du serveur d'adrkit, c'est le cimetière. list_superseded et la section d'historique de get_decision_context renvoient les décisions rejetées et remplacées à côté des décisions acceptées, si bien qu'un agent qui prépare une modification de src/db/ voit que MySQL a été essayé puis remplacé avant de proposer MySQL à nouveau. Les serveurs de mémoire génériques stockent ce qu'un agent a choisi de garder ; celui-ci lit des enregistrements que des personnes ont relus et fusionnés.
La surface se compose de quatre outils, tous annotés en lecture seule et en monde fermé : search_decisions (recherche littérale de sous-chaîne dans l'id, le titre, les tags et le corps), get_decision, get_decision_context pour jusqu'à 256 fichiers relatifs au dépôt, et list_superseded. get_decision_context compare les chemins aux motifs affects de chaque enregistrement et n'ouvre jamais les fichiers. Les résultats sont paginés par 20 par défaut et 100 au plus, et les enregistrements de plus de 64 Kio sont exclus avec un signalement plutôt que tronqués. Le coût en contexte reste ainsi faible et prévisible.
Le hic : sa valeur dépend entièrement d'un corpus que la plupart des équipes n'ont pas. Les enregistrements doivent avoir le frontmatter d'adrkit et, pour l'association aux fichiers, un champ affects bien tenu ; adr migrate --from madr l'ajoute à un corpus MADR existant, mais il faut toujours que quelqu'un écrive les motifs. Le projet n'a pas atteint la 1.0 et son propre README demande de figer une version. La recherche se fait par sous-chaîne littérale, sans classement ni embeddings par choix, donc l'agent doit deviner les mots qu'emploie un enregistrement. Le plugin pour agents ne fournit volontairement aucune configuration MCP, car Copilot CLI lance les serveurs de plugins hors du dépôt, si bien que chaque projet branche le serveur lui-même.
Côté sécurité, c'est à peu près aussi restreint qu'un serveur MCP peut l'être. Il lit du Markdown sous un seul répertoire dans un seul worktree git, rejette les échappements par liens symboliques, n'appelle ni modèle ni réseau, n'ouvre aucun port et n'écrit rien. L'exposition à l'injection de prompt, ce sont les corps des enregistrements eux-mêmes, que peut modifier quiconque a le droit de fusionner dans le dépôt. Le serveur REST distinct de l'image conteneur est une autre affaire : il n'authentifie personne, et le README prévient que quiconque atteint son port peut lire tous les corpus qu'il sert.
Là où il fait la différence
Une équipe plateforme de huit personnes avec 60 ADR dans docs/adr
Empêcher l'agent de code de reproposer le système de files d'attente que l'équipe a rejeté l'an dernier
Ajoutez le serveur au .vscode/mcp.json du projet ou à la configuration de Claude et demandez à l'agent d'appeler get_decision_context sur les fichiers avant de planifier. L'enregistrement rejeté apparaît dans l'historique. Gratuit ; une exécution de migrate et quelques motifs affects à écrire.
Une staff engineer qui relit un plan rédigé par un agent
Vérifier quelles décisions acceptées une modification proposée touche
Faites lister par l'agent les fichiers que modifie le plan et appeler get_decision_context, puis get_decision sur chaque enregistrement applicable pour citer ses contraintes. Va de pair avec la GitHub Action, qui publie la même réponse sur la pull request.
Un cabinet de conseil qui reprend le code d'un client avec des fichiers MADR
Donner aux agents l'historique des décisions du client sans construire de base de connaissances
Lancez adr migrate --from madr pour ajouter le frontmatter adrkit sur place, puis pointez adrkit-mcp vers le dépôt avec --cwd. L'outillage MADR d'origine continue de fonctionner, car le schéma en est un surensemble.
Avant de vous engager
- Mise en route
- npx -y @adrkit/mcp --cwd /path/to/repo --dir docs/adr sur Node 22+, ou l'image ghcr.io/mbeacom/adrkit avec mcp et un montage en lecture seule. Les configurations du README couvrent Claude Desktop, VS Code, Cursor et GitHub Copilot CLI. --cwd doit être la racine d'un worktree git.
- Intégrations
- Quatre outils en lecture seule : search_decisions, get_decision, get_decision_context et list_superseded. Parle les révisions du protocole MCP de 2025 et du 2026-07-28 en stdio. Le projet dans son ensemble ajoute une CLI, une Action pour les pull requests, une extension Spec Kit et un plugin pour agents.
- Données et confidentialité
- Lit les enregistrements Markdown sous un répertoire d'ADR dans un dépôt, avec des vérifications realpath contre les échappements par liens symboliques. Ni écriture, ni appel de modèle, ni accès réseau, ni index persistant, et aucun port. L'agent fait confiance au texte des enregistrements, donc gérez les droits de fusion sur docs/adr en conséquence. Le serveur REST distinct du conteneur n'a pas d'authentification.
- Coût à grande échelle
- Gratuit sous Apache-2.0. Chaque tools/call recharge le corpus, le coût se limite donc à des lectures de fichiers locaux ; les pages de sortie plafonnent à 100 éléments.
- Limites
- Environ 12 issues ouvertes. Recherche littérale uniquement ; les remplacements ne sont suivis que sur un niveau ; les références fédérées log:id sont reconnues mais jamais résolues ; un corpus par serveur ; les hôtes de plugins de Copilot CLI ne peuvent pas le lancer.
Les points forts
- Fait remonter les décisions rejetées et remplacées
- Quatre outils en lecture seule ; ni réseau, ni modèle, ni écriture
- Associe les fichiers aux décisions qui les régissent par motifs
- Sortie bornée et paginée qui garde le contexte réduit
Les points faibles
- Inutile sans corpus d'ADR au format adrkit
- Recherche par sous-chaîne littérale uniquement, sans classement
- Avant la 1.0 ; le projet conseille de figer les versions
- Chaque projet doit brancher le serveur lui-même
Idéal pour
Équipes qui tiennent déjà des architecture decision records dans git et veulent que les agents de code les consultent avant de proposer une conception.
Alternatives à adrkit MCP
adrkit MCP : questions fréquentes
- adrkit MCP vaut-il le coup ?
- Un petit serveur strictement en lecture seule qui fait bien une seule chose, détourner un agent d'une voie que l'équipe a déjà rejetée, à condition que vos décisions soient rédigées au format adrkit. Nous lui donnons 3.6 sur 5.
- Combien coûte adrkit MCP ?
- Gratuit et open source (Apache-2.0 ; le schéma est aussi en CC0). Pas de service hébergé ni d'offre payante.
- Quels sont les inconvénients de adrkit MCP ?
- Inutile sans corpus d'ADR au format adrkit; recherche par sous-chaîne littérale uniquement, sans classement; avant la 1.0 ; le projet conseille de figer les versions; chaque projet doit brancher le serveur lui-même.
- À qui s’adresse adrkit MCP ?
- Équipes qui tiennent déjà des architecture decision records dans git et veulent que les agents de code les consultent avant de proposer une conception.
- Combien coûte adrkit MCP pour une équipe ou en production ?
- Gratuit sous Apache-2.0. Chaque tools/call recharge le corpus, le coût se limite donc à des lectures de fichiers locaux ; les pages de sortie plafonnent à 100 éléments.
- adrkit MCP est-il sûr pour les données de l’entreprise ?
- Lit les enregistrements Markdown sous un répertoire d'ADR dans un dépôt, avec des vérifications realpath contre les échappements par liens symboliques. Ni écriture, ni appel de modèle, ni accès réseau, ni index persistant, et aucun port. L'agent fait confiance au texte des enregistrements, donc gérez les droits de fusion sur docs/adr en conséquence. Le serveur REST distinct du conteneur n'a pas d'authentification.
- Quelles sont les meilleures alternatives à adrkit MCP ?
- Les alternatives les plus proches que nous avons testées sont MCP Memory Keeper, Memory (reference server) et codebase-memory-mcp.
Réponses vérifiées le 11 nov. 2026.