MCP ADR Analysis Server

AI-powered architectural decision analysis and ADR management for AI coding assistants.

Unverified

stdio (local)

API key

TypeScript

View repo 30 Website npm

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run

npm install -g mcp-adr-analysis-server

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-adr-analysis-server": {
      "command": "mcp-adr-analysis-server",
      "args": [],
      "env": {
        "PROJECT_PATH": "/path/to/your/project",
        "OPENROUTER_API_KEY": "your_key_here",
        "EXECUTION_MODE": "full"
      }
    }
  }
}

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

Node.js 20.0.0 or higher
npm 9.0.0 or higher
An MCP-compatible client (Claude Desktop, Cline, Cursor, or Windsurf)
Internet access during npm install for native tree-sitter module compilation
Optional: OpenRouter API key for full AI analysis mode (otherwise prompt-only mode)

About MCP ADR Analysis Server

MCP ADR Analysis Server provides AI-powered architectural decision analysis and ADR management to AI coding assistants. It detects tech stacks and patterns, generates and maintains Architectural Decision Records, performs Smart Code Linking between ADRs and implementation code, builds a knowledge graph, masks sensitive content, and enforces deployment-readiness validation. In full mode (with an OpenRouter key) it returns real analysis results with ~95% confidence scoring across 73 tools; in prompt-only mode (default, no key) it returns analysis prompts plus local file operations and ADR discovery.

Tools & capabilities (13)

analyze_project_ecosystem

Analyze a project's architecture, technology stack, and patterns (comprehensive analysis).

suggest_adrs

Suggest ADRs for implicit architectural decisions found in the codebase.

generate_adr_from_decision

Generate an ADR file from a structured architectural decision.

generate_adrs_from_prd

Generate ADRs from a PRD/requirements document into an output directory.

find_related_code

Smart Code Linking: discover code files related to an ADR using AI keyword extraction and ripgrep search.

perform_research

Perform web research for architectural analysis using external sources (requires Firecrawl).

sync_to_aggregator

Push local ADRs to the ADR Aggregator platform (requires ADR Aggregator API key).

get_adr_context

Pull ADR context from the ADR Aggregator platform.

get_staleness_report

Get ADR governance/health and staleness reports from the ADR Aggregator.

get_adr_templates

Retrieve domain-specific ADR templates from the ADR Aggregator.

get_adr_diagrams

Get Mermaid diagrams for ADRs (ADR Aggregator Pro+).

validate_adr_compliance

Validate ADR implementation/compliance (ADR Aggregator Pro+).

get_knowledge_graph

Retrieve a cross-repository architectural knowledge graph (ADR Aggregator Team).

What this server can do

MCP ADR Analysis Server provides tools for these capabilities — tap one to see every MCP server that does the same:

Manage Git repos

When to use it

Enhance AI coding assistants (Claude, Cline, Cursor) with architectural intelligence
Generate and maintain Architectural Decision Records from code or PRDs
Answer architecture questions with confidence scoring in conversational AI
Run autonomous agents for continuous analysis and rule enforcement
Enterprise portfolio analysis, migration planning, and cross-team ADR governance
Detect and mask sensitive content and validate deployment readiness

Security notes

Requires an OpenRouter API key (OPENROUTER_API_KEY) for full AI analysis mode; without it the server runs in prompt-only mode with no key required. Optional FIRECRAWL_API_KEY enables web research and optional ADR_AGGREGATOR_API_KEY enables cross-team ADR sync. Includes automatic secret detection and content masking; processing is local by default.

MCP ADR Analysis Server FAQ

Do I need an API key to use it?

No. The server defaults to prompt-only mode (EXECUTION_MODE=prompt-only), which works without a key and returns prompts plus local file operations and ADR discovery. Set OPENROUTER_API_KEY and EXECUTION_MODE=full to get actual AI analysis results with confidence scoring.

How many tools does it expose?

73 MCP tools for architectural analysis in full mode. Some advanced features (Smart Code Linking, Knowledge Graph, web research) require full mode with an API key.

Is Firecrawl or ADR Aggregator required?

No, both are optional. Firecrawl (FIRECRAWL_API_KEY) adds web research; ADR Aggregator (ADR_AGGREGATOR_API_KEY) adds cross-team ADR sync and governance. All core analysis features work without them.

Why do I need internet access during install?

The server compiles native tree-sitter parsers for incremental code analysis. If native builds fail it falls back to a reduced mode without tree-sitter code analysis.

#adr #architecture #code-analysis #architectural-decision-records #ai-agents #openrouter #tree-sitter #knowledge-graph

Alternatives to MCP ADR Analysis Server

Compare all alternatives →

Playwright MCP Server

Developer Tools

24k

Microsoft's official browser-automation MCP using Playwright's accessibility tree (no vision model).

Featured

Verified

stdio (local)

No auth

TypeScript

12 tools

Updated 21 days agoRepo

Context7 MCP Server

Developer Tools

28k

Up-to-date, version-specific library documentation injected into your coding agent.

Verified

stdio (local)

API key

TypeScript

2 tools

Updated 25 days agoRepo

codebase-memory-mcp

Developer Tools

16k

Code intelligence engine that indexes repos into a persistent knowledge graph for AI coding agents.

Unverified

stdio (local)

No auth

14 tools

Updated 11 hours agoRepo

Compare MCP ADR Analysis Server with:

vs Playwright MCP Server vs Context7 MCP Server vs codebase-memory-mcp vs Serena