tosin2013/mcp-adr-analysis-server

Overview

An open-source Model Context Protocol (MCP) server that analyzes Architectural Decision Records (ADRs) and surfaces architectural insights to AI agents. Built in TypeScript, it enables AI tools to query and reason over ADR content.

Best for

Best for
Developers and architects who want to integrate ADR analysis into AI-assisted workflows

Use cases

• Feed ADRs into an AI coding assistant to inform architecture decisions
• Automate review of ADRs for consistency and completeness
• Provide architectural context to AI agents during code generation or refactoring

How to use

Install

npx mcp-adr-analysis-server

Tools exposed

• sync_to_aggregator
• get_adr_context
• get_staleness_report
• get_adr_templates
• get_adr_diagrams
• validate_adr_compliance
• get_knowledge_graph

Tested with

Claude Desktop, Cursor, Windsurf, Cline, VS Code

Notes

An open-source Model Context Protocol (MCP) server that analyzes Architectural Decision Records (ADRs) and surfaces architectural insights to AI agents. Built in TypeScript, it enables AI tools to query and reason over ADR content.

28 stars on GitHub. Last updated 2026-05-26. Licensed MIT.

Use cases

• Feed ADRs into an AI coding assistant to inform architecture decisions
• Automate review of ADRs for consistency and completeness
• Provide architectural context to AI agents during code generation or refactoring

Pros

• Specialized for ADR analysis, a niche but valuable use case
• Leverages the MCP standard for interoperability with AI agents
• Open source with a clear focus and TypeScript codebase

Cons

• Small community (28 stars) limits support and contributions
• Requires an MCP-compatible AI agent to be useful
• Early-stage project with potentially limited documentation and stability

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.