¿Qué es adrkit MCP?
adrkit trata los registros de decisiones de arquitectura (ADR, documentos breves que recogen una elección de diseño y su motivo) como datos tipados: archivos Markdown en git con frontmatter YAML, un estado como accepted, rejected o superseded y un campo affects que vincula cada decisión a rutas o paquetes. Su paquete @adrkit/mcp es un servidor stdio local que permite a un agente buscar en ese corpus, obtener un registro, listar las decisiones que rigen un conjunto de archivos y listar lo que ha quedado sustituido.
El proyecto es de Mark Beacom (usuario de GitHub mbeacom), tiene licencia Apache-2.0 y está escrito en TypeScript para Node 22 o posterior. Figura en el registro oficial de MCP como dev.adrkit/mcp. La versión 0.20.0 se publicó el 11 de octubre de 2026; el repositorio tenía 24 estrellas y su último push fue el 7 de noviembre. El mismo monorepo incluye una CLI, una GitHub Action que comenta en los pull requests las decisiones que los rigen y un plugin para Claude Code y Copilot.
Cómo instalar adrkit MCP
npx -y @adrkit/mcp --cwd /path/to/repo --dir docs/adr¿Merece la pena adrkit MCP?
Lo valioso del servidor de adrkit es el cementerio. list_superseded y la sección de historial de get_decision_context devuelven las decisiones rechazadas y sustituidas junto a las aceptadas, así que un agente que planea un cambio en src/db/ ve que MySQL se probó y se reemplazó antes de proponer MySQL otra vez. Los servidores de memoria genéricos guardan lo que un agente decidió guardar; este lee registros que personas revisaron y fusionaron.
La superficie son cuatro herramientas, todas anotadas como de solo lectura y de mundo cerrado: search_decisions (búsqueda literal de subcadenas en id, título, etiquetas y cuerpo), get_decision, get_decision_context para hasta 256 archivos relativos al repositorio y list_superseded. get_decision_context compara rutas con los patrones affects de cada registro y nunca abre los archivos. Los resultados se paginan de 20 en 20 por defecto y 100 como máximo, y los registros de más de 64 KiB se excluyen con un aviso en lugar de truncarse. Eso mantiene el coste de contexto pequeño y previsible.
La pega: el valor depende por completo de un corpus que la mayoría de los equipos no tiene. Los registros necesitan el frontmatter de adrkit y, para emparejar archivos, un campo affects bien mantenido; adr migrate --from madr lo añade a un corpus MADR existente, pero alguien sigue teniendo que escribir los patrones. El proyecto es anterior a la 1.0 y su propio README pide fijar una versión. La búsqueda es por subcadena literal, sin ranking ni embeddings por diseño, así que el agente tiene que adivinar las palabras que usa un registro. El plugin para agentes no incluye a propósito configuración MCP, porque Copilot CLI arranca los servidores de plugins fuera del repositorio, así que cada proyecto conecta el servidor por su cuenta.
En seguridad, es casi lo más acotado que puede ser un servidor MCP. Lee Markdown bajo un directorio dentro de un único worktree de git, rechaza escapes por enlaces simbólicos, no hace llamadas a modelos ni a la red, no abre ningún puerto y no escribe nada. La exposición a inyección de prompts son los propios cuerpos de los registros, que puede editar cualquiera que pueda fusionar en el repositorio. El servidor REST aparte de la imagen de contenedor es otra cosa: no autentica a nadie, y el README advierte de que cualquiera que llegue a su puerto puede leer todos los corpus que sirve.
Dónde se gana su sitio
Un equipo de plataforma de ocho personas con 60 ADR en docs/adr
Evitar que el agente de programación vuelva a proponer el sistema de colas que el equipo rechazó el año pasado
Añade el servidor al .vscode/mcp.json del proyecto o a la configuración de Claude y pide al agente que llame a get_decision_context sobre los archivos antes de planificar. El registro rechazado aparece en el historial. Gratis; una ejecución de migrate y algunos patrones affects que escribir.
Una staff engineer que revisa un plan escrito por un agente
Comprobar qué decisiones aceptadas toca un cambio propuesto
Haz que el agente liste los archivos que cambia el plan y llame a get_decision_context, y después a get_decision sobre cada registro aplicable para citar sus restricciones. Encaja con la GitHub Action, que publica la misma respuesta en el pull request.
Una consultora que hereda el código de un cliente con archivos MADR
Dar a los agentes el historial de decisiones del cliente sin montar una base de conocimiento
Ejecuta adr migrate --from madr para añadir el frontmatter de adrkit en el sitio y apunta adrkit-mcp al repositorio con --cwd. Las herramientas MADR originales siguen funcionando porque el esquema es un superconjunto.
Antes de decidirte
- Puesta en marcha
- npx -y @adrkit/mcp --cwd /path/to/repo --dir docs/adr en Node 22+, o la imagen ghcr.io/mbeacom/adrkit con mcp y un montaje de solo lectura. Las configuraciones del README cubren Claude Desktop, VS Code, Cursor y GitHub Copilot CLI. --cwd debe ser la raíz de un worktree de git.
- Integraciones
- Cuatro herramientas de solo lectura: search_decisions, get_decision, get_decision_context y list_superseded. Habla las revisiones del protocolo MCP de 2025 y de 2026-07-28 por stdio. El proyecto en conjunto añade una CLI, una Action para pull requests, una extensión de Spec Kit y un plugin para agentes.
- Datos y privacidad
- Lee registros Markdown bajo un directorio de ADR dentro de un repositorio, con comprobaciones de realpath contra escapes por enlaces simbólicos. Sin escrituras, llamadas a modelos, acceso a la red ni índice persistente, y sin puerto. El agente confía en el texto de los registros, así que trata los permisos de fusión en docs/adr en consecuencia. El servidor REST aparte del contenedor no tiene autenticación.
- Coste a escala
- Gratis con Apache-2.0. Cada tools/call vuelve a cargar el corpus, así que el coste son lecturas de archivos locales; las páginas de salida se limitan a 100 elementos.
- Límites
- Unos 12 issues abiertos. Solo búsqueda literal; la sustitución se sigue un único salto; las referencias federadas log:id se reconocen pero nunca se resuelven; un corpus por servidor; los hosts de plugins de Copilot CLI no pueden lanzarlo.
Lo bueno
- Muestra las decisiones rechazadas y sustituidas
- Cuatro herramientas de solo lectura; sin red, modelo ni escrituras
- Asocia archivos a las decisiones que los rigen por patrones
- Salida acotada y paginada que mantiene el contexto pequeño
Lo malo
- Inútil sin un corpus de ADR en formato adrkit
- Solo búsqueda literal por subcadena, sin ranking
- Anterior a la 1.0; el proyecto aconseja fijar versiones
- Cada proyecto debe conectar el servidor por su cuenta
Ideal para
Equipos que ya guardan registros de decisiones de arquitectura en git y quieren que los agentes de programación los consulten antes de proponer un diseño.
Alternativas a adrkit MCP
adrkit MCP: preguntas frecuentes
- ¿Merece la pena adrkit MCP?
- Un servidor pequeño y estrictamente de solo lectura que hace bien una sola cosa, apartar a un agente de un camino que el equipo ya rechazó, siempre que tus decisiones estén escritas en el formato de adrkit. Le damos un 3.6 sobre 5.
- ¿Cuánto cuesta adrkit MCP?
- Gratuito y de código abierto (Apache-2.0; el esquema también es CC0). Sin servicio alojado ni plan de pago.
- ¿Qué inconvenientes tiene adrkit MCP?
- Inútil sin un corpus de ADR en formato adrkit; solo búsqueda literal por subcadena, sin ranking; anterior a la 1.0; el proyecto aconseja fijar versiones; cada proyecto debe conectar el servidor por su cuenta.
- ¿Para quién es adrkit MCP?
- Equipos que ya guardan registros de decisiones de arquitectura en git y quieren que los agentes de programación los consulten antes de proponer un diseño.
- ¿Cuánto cuesta adrkit MCP para un equipo o en producción?
- Gratis con Apache-2.0. Cada tools/call vuelve a cargar el corpus, así que el coste son lecturas de archivos locales; las páginas de salida se limitan a 100 elementos.
- ¿Es adrkit MCP seguro para los datos de la empresa?
- Lee registros Markdown bajo un directorio de ADR dentro de un repositorio, con comprobaciones de realpath contra escapes por enlaces simbólicos. Sin escrituras, llamadas a modelos, acceso a la red ni índice persistente, y sin puerto. El agente confía en el texto de los registros, así que trata los permisos de fusión en docs/adr en consecuencia. El servidor REST aparte del contenedor no tiene autenticación.
- ¿Cuáles son las mejores alternativas a adrkit MCP?
- Las alternativas más cercanas que hemos analizado son MCP Memory Keeper, Memory (reference server) y codebase-memory-mcp.
Respuestas comprobadas el 11 nov 2026.