ADR Analysis

ADR Analysis

MCP server delivering AI-powered architectural analysis, ADR management, and code discovery.

14
Stars
5
Forks
20
Releases

Overview

An MCP ADR Analysis Server that provides AI-powered architectural analysis for intelligent development workflows. It integrates with OpenRouter.ai to deliver immediate architectural insights, detects technology stacks and patterns, and helps generate and maintain Architectural Decision Records (ADRs). The server features Smart Code Linking to surface code files related to ADR decisions, enabling developers to quickly navigate from ADRs to implementation. It emphasizes concrete results rather than prompts, returning actual analysis outputs with a 95% confidence scoring model. Security and compliance are baked in: automatic secret detection and content masking with local processing for zero-trust environments. It includes a two-phase Test-Driven Development (TDD) workflow with validation to ensure ADRs align with requirements and code changes. Deployment readiness checks enforce quality via hard blocking on failed tests or criteria. The stack includes Node.js 20+, TypeScript, MCP SDK, Jest, ripgrep, fast-glob, OpenRouter.ai, and optional web research via Firecrawl. The README also describes installation methods (global, npx, RHEL installer), and comprehensive guides for configuration, usage, and troubleshooting.

Details

Owner
tosin2013
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

AI-Powered Analysis

Delivers immediate architectural insights using OpenRouter.ai integration, providing concrete results rather than prompts.

Technology Detection

Identifies languages, frameworks, libraries and architectural patterns to inform ADRs.

ADR Management

Generates, suggests, and maintains Architectural Decision Records to capture decisions and rationale.

Smart Code Linking

AI-powered discovery of code files related to ADRs and decisions, enabling quick navigation.

Security & Compliance

Detects sensitive content, masks data, and supports zero-trust processing and compliance checks.

TDD Integration

Two-phase Test-Driven Development workflow with validation to ensure ADRs align with requirements and code changes.

Deployment Readiness

Zero-tolerance test validation with hard blocking to prevent unsuitable deployments.

Audience

AI coding assistantsEnhance Claude, Cline, and Cursor with architectural intelligence for real-time ADR analysis.
Enterprise architectsPortfolio-level ADR management and technology stack insights for migration planning.
Development teamsGuide decisions, validate ADRs, and support TDD workflows within projects.

Tags

ADRArchitectural DecisionsAI-powered analysisADR ManagementCode LinkingSecurity MaskingTDDDeployment ReadinessOpenRouter.aiMCP