O que é adrkit MCP?
O adrkit trata registros de decisões de arquitetura (ADRs, documentos curtos que registram uma escolha de design e o motivo dela) como dados tipados: arquivos Markdown no git com frontmatter YAML, um status como accepted, rejected ou superseded e um campo affects que liga cada decisão a caminhos ou pacotes. O pacote @adrkit/mcp é um servidor stdio local que permite a um agente buscar nesse acervo, obter um registro, listar as decisões que regem um conjunto de arquivos e listar o que foi substituído.
O projeto é de Mark Beacom (usuário do GitHub mbeacom), tem licença Apache-2.0 e é escrito em TypeScript para Node 22 ou posterior. Está listado no registro oficial do MCP como dev.adrkit/mcp. A versão 0.20.0 saiu em 11 de outubro de 2026; o repositório tinha 24 estrelas e o último push foi em 7 de novembro. O mesmo monorepo traz uma CLI, uma GitHub Action que comenta nos pull requests as decisões que os regem e um plugin para Claude Code e Copilot.
Como instalar adrkit MCP
npx -y @adrkit/mcp --cwd /path/to/repo --dir docs/adradrkit MCP vale a pena?
O valor do servidor do adrkit é o cemitério. list_superseded e a seção de histórico de get_decision_context devolvem decisões rejeitadas e substituídas junto com as aceitas, então um agente que planeja uma mudança em src/db/ vê que o MySQL foi testado e substituído antes de propor MySQL de novo. Servidores de memória genéricos guardam o que um agente escolheu salvar; este lê registros que pessoas revisaram e fizeram merge.
A superfície são quatro ferramentas, todas anotadas como somente leitura e de mundo fechado: search_decisions (busca literal por substring em id, título, tags e corpo), get_decision, get_decision_context para até 256 arquivos relativos ao repositório e list_superseded. get_decision_context compara caminhos com os padrões affects de cada registro e nunca abre os arquivos. Os resultados são paginados de 20 em 20 por padrão e no máximo 100, e registros acima de 64 KiB são excluídos com um aviso em vez de truncados. Isso mantém o custo de contexto pequeno e previsível.
O porém: o valor depende inteiramente de um acervo que a maioria das equipes não tem. Os registros precisam do frontmatter do adrkit e, para associar arquivos, de um campo affects bem mantido; adr migrate --from madr adiciona isso a um acervo MADR existente, mas alguém ainda precisa escrever os padrões. O projeto é anterior à 1.0 e o próprio README pede para fixar uma versão. A busca é por substring literal, sem ranking nem embeddings por decisão de projeto, então o agente precisa adivinhar as palavras que um registro usa. O plugin para agentes de propósito não traz configuração MCP, porque o Copilot CLI inicia os servidores de plugins fora do repositório, então cada projeto conecta o servidor por conta própria.
Em segurança, é quase o mais restrito que um servidor MCP pode ser. Ele lê Markdown sob um diretório dentro de um único worktree do git, rejeita fugas por links simbólicos, não faz chamadas a modelos nem à rede, não abre porta e não grava nada. A exposição a prompt injection são os próprios corpos dos registros, que qualquer pessoa com permissão de merge no repositório pode editar. O servidor REST separado da imagem de contêiner é outra história: ele não autentica ninguém, e o README avisa que qualquer um que alcance a porta dele pode ler todos os acervos que ele serve.
Onde ele se destaca
Uma equipe de plataforma de oito pessoas com 60 ADRs em docs/adr
Impedir que o agente de programação proponha de novo o sistema de filas que a equipe rejeitou no ano passado
Adicione o servidor ao .vscode/mcp.json do projeto ou à configuração do Claude e instrua o agente a chamar get_decision_context nos arquivos antes de planejar. O registro rejeitado aparece no histórico. Gratuito; uma execução de migrate e alguns padrões affects para escrever.
Uma staff engineer revisando um plano escrito por um agente
Verificar quais decisões aceitas uma mudança proposta afeta
Peça ao agente para listar os arquivos que o plano altera e chamar get_decision_context, depois get_decision em cada registro aplicável para citar suas restrições. Combina com a GitHub Action, que publica a mesma resposta no pull request.
Uma consultoria que herda a base de código de um cliente com arquivos MADR
Dar aos agentes o histórico de decisões do cliente sem montar uma base de conhecimento
Rode adr migrate --from madr para adicionar o frontmatter do adrkit no lugar e aponte o adrkit-mcp para o repositório com --cwd. As ferramentas MADR originais continuam funcionando porque o schema é um superconjunto.
Antes de decidir
- Configuração
- npx -y @adrkit/mcp --cwd /path/to/repo --dir docs/adr no Node 22+, ou a imagem ghcr.io/mbeacom/adrkit com mcp e uma montagem somente leitura. As configurações do README cobrem Claude Desktop, VS Code, Cursor e GitHub Copilot CLI. --cwd precisa ser a raiz de um worktree do git.
- Integrações
- Quatro ferramentas somente leitura: search_decisions, get_decision, get_decision_context e list_superseded. Suporta as revisões do protocolo MCP de 2025 e de 2026-07-28 via stdio. O projeto como um todo adiciona uma CLI, uma Action para pull requests, uma extensão do Spec Kit e um plugin para agentes.
- Dados e privacidade
- Lê registros Markdown sob um diretório de ADRs dentro de um repositório, com verificações de realpath contra fugas por links simbólicos. Sem gravações, chamadas a modelos, acesso à rede ou índice persistente, e sem porta. O agente confia no texto dos registros, então trate as permissões de merge em docs/adr de acordo. O servidor REST separado do contêiner não tem autenticação.
- Custo em escala
- Gratuito sob Apache-2.0. Cada tools/call recarrega o acervo, então o custo são leituras de arquivos locais; as páginas de saída param em 100 itens.
- Limites
- Cerca de 12 issues abertas. Só busca literal; a substituição é seguida por um único salto; referências federadas log:id são reconhecidas, mas nunca resolvidas; um acervo por servidor; hosts de plugins do Copilot CLI não conseguem iniciá-lo.
O que é bom
- Mostra decisões rejeitadas e substituídas
- Quatro ferramentas somente leitura; sem rede, modelo ou gravações
- Associa arquivos às decisões que os regem por padrões
- Saída limitada e paginada mantém o contexto pequeno
O que não é
- Inútil sem um acervo de ADRs no formato do adrkit
- Só busca literal por substring, sem ranking
- Anterior à 1.0; o projeto recomenda fixar versões
- Cada projeto precisa conectar o servidor por conta própria
Ideal para
Equipes que já mantêm registros de decisões de arquitetura no git e querem que agentes de programação os consultem antes de propor um design.
Alternativas ao adrkit MCP
adrkit MCP: perguntas frequentes
- adrkit MCP vale a pena?
- Um servidor pequeno e estritamente somente leitura que faz bem uma única coisa, afastar um agente de um caminho que a equipe já rejeitou, desde que suas decisões estejam escritas no formato do adrkit. Damos nota 3.6 de 5.
- Quanto custa adrkit MCP?
- Gratuito e de código aberto (Apache-2.0; o schema também é CC0). Sem serviço hospedado ou plano pago.
- Quais são as desvantagens de adrkit MCP?
- Inútil sem um acervo de ADRs no formato do adrkit; só busca literal por substring, sem ranking; anterior à 1.0; o projeto recomenda fixar versões; cada projeto precisa conectar o servidor por conta própria.
- Para quem adrkit MCP é indicado?
- Equipes que já mantêm registros de decisões de arquitetura no git e querem que agentes de programação os consultem antes de propor um design.
- Quanto custa adrkit MCP para uma equipe ou em produção?
- Gratuito sob Apache-2.0. Cada tools/call recarrega o acervo, então o custo são leituras de arquivos locais; as páginas de saída param em 100 itens.
- adrkit MCP é seguro para dados da empresa?
- Lê registros Markdown sob um diretório de ADRs dentro de um repositório, com verificações de realpath contra fugas por links simbólicos. Sem gravações, chamadas a modelos, acesso à rede ou índice persistente, e sem porta. O agente confia no texto dos registros, então trate as permissões de merge em docs/adr de acordo. O servidor REST separado do contêiner n ão tem autenticação.
- Quais são as melhores alternativas ao adrkit MCP?
- As alternativas mais próximas que analisamos são MCP Memory Keeper, Memory (reference server) e codebase-memory-mcp.
Respostas verificadas em 11 de nov. de 2026.