tosin2013/mcp-adr-analysis-server

> **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
- What is MCP?
- Prerequisites
- Quick Installation
- Quick Setup
- Usage Examples
- Use Cases
- Technology Stack
- Project Structure
- Testing
- ADR Aggregator Integration
- Development
- Troubleshooting
- Security & Performance
- Contributing
- Resources
- License
What is MCP?
The **Model Context Protocol (MCP)** is an open standard that enables seamless integration between AI assistants and external tools and data sources. Think of it as a universal adapter that lets AI assistants like Claude, Cline, and Cursor connect to specialized servers. This server gives your AI assistant the ability to detect ADR drift against live code, mask sensitive content before it leaks, and remember architectural decisions across conversations.
TL;DR
**What:** MCP server that validates architectural decisions against your actual code — drift detection, content safety, and decision memory
**Who:** AI coding assistants (Claude, Cline, Cursor, Windsurf), enterprise architects, development teams
**Why:** Catch stale ADRs before they cause production incidents — live validation against code evidence, no API key required
**How:** npm install -g mcp-adr-analysis-server → Add to your MCP client → Start analyzing
**Key Features:** Tree-sitter AST analysis • Security content masking • Drift detection • CE-MCP orchestration directives • Deployment readiness validation
Key Terms
| Term | Definition |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **ADR** | **Architectural Decision Record** — A document that captures an important architectural decision along with its context, alternatives considered, and consequences. |
| **MCP** | **Model Context Protocol** — An open standard enabling AI assistants to connect to external tools and data sources. |
| **CE-MCP** | **Claude-Enriched MCP** — Execution mode where tools return orchestration directives for the host LLM instead of making their own AI calls. Default since v2.14. |
| **Tree-sitter** | An incremental parsing library that provides AST (Abstract Syntax Tree) analysis for 50+ languages. Used for semantic code understanding, extracting function signatures, and identifying architectural patterns. |
| **Session & Tool-Usage Tracker** | Project-local tracking of session intents, tool executions, and ADR registrations, with keyword-scored retrieval over JSON snapshots. Supports workflow continuity and tool-usage evidence — not a graph database. |
| **Smart Code Linking** | Discovery of code files related to ADRs and architectural decisions, using keyword extraction and ripgrep search. |
| **ADR Aggregator** | Optional SaaS integration for syncing and sharing ADR context across teams (ADR_AGGREGATOR_API_KEY). |
---
**Author**: Tosin Akinosho | **Repository**: GitHub | **Version**: 2.14.12
✨ Core Capabilities
🔄 **Drift Detection** - Validate ADR decisions against live code and infrastructure evidence
🛡️ **Content Safety** - Detect and mask secrets, PII, and sensitive content automatically
🧠 **Decision Memory** - Session & tool-usage tracking with keyword-scored retrieval
🏗️ **Technology Detection** - Identify any tech stack and architectural patterns
📋 **ADR Management** - Generate, suggest, and maintain Architectural Decision Records
🔗 **Smart Code Linking** - Discovery of code files related to ADRs and decisions
🚀 **Deployment Readiness** - Zero-tolerance test validation with hard blocking
📖 **View Full Capabilities →** · 📜 **Release policy →** · 🗒️ **Changelog →**
Prerequisites
Before installing, verify you have:
**Required:**
- **Node.js 20.0.0 or higher** — Download or use nvm/fnm