tosin2013 avatar

Mcp Adr Analysis Server

tosin2013/mcp-adr-analysis-server

This server gives AI assistants like Claude and Cursor the ability to analyze and manage Architectural Decision Records in your codebase. It exposes tools to generate ADRs, detect technology stacks, and link decisions to relevant code files using tree-sitter AST parsing across 50+ languages. The analysis runs through OpenRouter.ai models and returns actual results with confidence scores, not prompts to run elsewhere. It includes security content masking, test-driven development validation, and a knowledge graph that tracks relationships between ADRs and implementations. Reach for this when you want your AI assistant to understand architectural decisions in context and automatically discover which code files relate to specific design choices.

GitHub stars
35
tools
7
auth
Secret needed
transport
STDIO
env vars
4
last updated
Oct 28, 2026

Tools

7 tools

Public tool metadata for what this MCP can expose to an agent.

sync_to_aggregatorPush local ADRs to platform

Push local ADRs to platform

No parameter schema in public metadata yet.

get_adr_contextPull ADR context from platform

Pull ADR context from platform

No parameter schema in public metadata yet.

get_staleness_reportGet ADR governance/health reports

Get ADR governance/health reports

No parameter schema in public metadata yet.

get_adr_templatesRetrieve domain-specific templates

Retrieve domain-specific templates

No parameter schema in public metadata yet.

get_adr_diagramsGet Mermaid diagrams for ADRs

Get Mermaid diagrams for ADRs

No parameter schema in public metadata yet.

validate_adr_complianceValidate ADR implementation

Validate ADR implementation

No parameter schema in public metadata yet.

get_knowledge_graphCross-repository knowledge graph

Cross-repository knowledge graph

No parameter schema in public metadata yet.

Sponsors

Configuration

PROJECT_PATH

Path to the project directory to analyze (defaults to current directory)

OPENROUTER_API_KEYsecret

OpenRouter API key for AI-powered analysis (required for full execution mode)

EXECUTION_MODE

Execution mode: 'ce-mcp' (default), 'full' for AI results, or 'prompt-only' for prompts

ADR_DIRECTORY

ADR directory relative to project path (default: docs/adrs)

Readme

MCP (Model Context Protocol) ADR (Architectural Decision Record) Analysis Server

GitHub License NPM Version Node.js TypeScript Good First Issues

Your ADRs are lying to you. This MCP server catches it — live drift detection validates architectural decisions against your actual code. Plus content safety, decision memory, and 63 tools powered by your host LLM via CE-MCP.

Table of contents


View the full README on GitHub

Details

Repository
github.com/tosin2013/mcp-adr-analysis-server
Category
AI & LLM Tools
Package
mcp-adr-analysis-server
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from tosin2013

Related AI & LLM Tools MCP servers

View all
1jonradoff avatarLightcmsjonradoff/lightcmsAI-native, open-source CMS (Go) with 128 MCP tools: content, agent sandbox, SEO & AI.34stars
2tokensafe-dev avatarTokenSafetokensafe-dev/tokensafeReduce your AI bills by up to 99% locally: focused code, warm prompt caches & zero secret leaks.33stars
3alejandro-m-p avatarGit Coureralejandro-m-p/git-courerFull git MCP server for LLM agents — 17 tools, AST annotator, auto-backups, real plumbing.32stars
4atxp-dev avatarATXP — Agent Payment & Wallet Infrastructureatxp-dev/atxpAgent wallet, email, phone, and 41 paid tools: search, image/video/music gen, SMS, calls.32stars
5nirholas avatarDeFi Trading Agentsnirholas/defi-agentsDeFi agent definitions JSON API - crypto trading portfolio management bots32stars
6pixelx-jp avatarPlateau Creative Mcppixelx-jp/plateau-creative-mcpPLATEAU 3D city data as scene-editing and glTF export tools for creative LLM agents.29stars