Mcp Adr Analysis Server

io.github.tosin2013Published by GitHub account tosin2013v2.14.19Updated Nov 3, 2026

ADR drift detection, content safety, and decision memory for architectural decisions

VerifiedSTDIODesktop onlyKnowledge & Memory Developer Tools Security & Monitoring

Server details

Identifier: io.github.tosin2013/mcp-adr-analysis-server
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account tosin2013 for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.tosin2013%2Fmcp-adr-analysis-server.svg)](https://sourceweft.com/mcp/io.github.tosin2013%2Fmcp-adr-analysis-server?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Local MCP server that checks Architectural Decision Records against real code, masks sensitive content, and tracks decisions across sessions.

What you can do: Analyze projects and codebases: ecosystem analysis, architectural context, codebase search, technology and environment detection
Manage ADRs: discover, suggest, generate from a PRD or decision data, review, validate against infrastructure, and analyze timelines
Turn decisions into work: generate TODO.md task breakdowns, architectural rules and rule sets, deployment guidance, and release tracking
Content safety: detect sensitive content, generate and apply masking, configure custom patterns and output masking
Deployment and workflow: readiness checks, guided bootstrap validation, git push with credential detection, workflow and troubleshooting guidance, health scoring
When to use it: Useful for teams and AI coding assistants working in a repository that keeps ADRs and wants to catch stale or unimplemented decisions, generate new ADRs from requirements, or screen content for secrets before it leaves the machine.
Requirements: Runs locally over stdio as an npm package; needs Node.js 20 or higher and npm 9 or higher, plus an MCP-compatible client. Internet access is needed during install for native tree-sitter builds, with a reduced mode if they fail. Optional environment variables: PROJECT_PATH, ADR_DIRECTORY, EXECUTION_MODE, and OPENROUTER_API_KEY only for full mode.

Before you install

Full execution mode sends analysis to OpenRouter and requires OPENROUTER_API_KEY, which incurs API costs; the README calls this mode not recommended. Several tools write to the project: ADR files, TODO.md, CHANGELOG.md, rule sets, bootstrap scripts, and GitHub releases and milestones. smart_git_push pushes code, and deployment readiness can block deployments. An optional ADR Aggregator key syncs ADRs to a third-party SaaS.

Installation

In SourceWeft

Open Mcp Adr Analysis Server in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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.

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:

bash

node --version  # Should show v20.0.0 or highernpm --version   # Should show 9.0.0 or higher (included with Node.js 20+)

node --version  # Should show v20.0.0 or highernpm --version   # Should show 9.0.0 or higher (included with Node.js 20+)

Required:

Node.js 20.0.0 or higher — Download or use nvm/fnm
npm 9.0.0 or higher (included with Node.js 20+)
An MCP-compatible client — Claude Desktop, Cline, Cursor, or Windsurf

Network Requirements

Internet access required during npm install for native module compilation (tree-sitter incremental code parsers for YAML and TypeScript)
If behind a corporate proxy, set HTTP_PROXY and HTTPS_PROXY environment variables
Offline fallback: If native builds fail, the server operates in reduced mode without tree-sitter code analysis

📦 Quick Installation

bash

# Option 1: Global installation (recommended for frequent use)npm install -g mcp-adr-analysis-server
# Option 2: Use npx (no installation required)npx mcp-adr-analysis-server
# Option 3: From source (for development or customization)git clone https://github.com/tosin2013/mcp-adr-analysis-server.gitcd mcp-adr-analysis-server && npm install && npm run build
# Option 4: RHEL 9/10 systems (special installer)curl -sSL https://raw.githubusercontent.com/tosin2013/mcp-adr-analysis-server/main/scripts/install-rhel.sh | bash

# Option 1: Global installation (recommended for frequent use)npm install -g mcp-adr-analysis-server
# Option 2: Use npx (no installation required)npx mcp-adr-analysis-server
# Option 3: From source (for development or customization)git clone https://github.com/tosin2013/mcp-adr-analysis-server.gitcd mcp-adr-analysis-server && npm install && npm run build
# Option 4: RHEL 9/10 systems (special installer)curl -sSL https://raw.githubusercontent.com/tosin2013/mcp-adr-analysis-server/main/scripts/install-rhel.sh | bash

Note: When installing from source, npm run build is required before running the server since the bin entry points to ./dist/src/index.js.

📖 Detailed Installation Guide → | RHEL Setup →

⚡ Quick Setup (2 Steps)

Install: npm install -g mcp-adr-analysis-server
Configure Client: Add to Claude Desktop, Cline, Cursor, or Windsurf — no API key required

json

{  "mcpServers": {    "adr-analysis": {      "command": "mcp-adr-analysis-server",      "env": {        "PROJECT_PATH": "/path/to/your/project"      }    }  }}

{  "mcpServers": {    "adr-analysis": {      "command": "mcp-adr-analysis-server",      "env": {        "PROJECT_PATH": "/path/to/your/project"      }    }  }}

That's it. The server runs in CE-MCP mode by default — your host LLM (Claude, GPT, etc.) executes the analysis using orchestration directives returned by the tools. No external API key needed.

Claude Desktop users: Save this JSON to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).

Config locations for other clients

Client	Config file location
Claude Desktop (macOS)	`~/Library/Application Support/Claude/claude_desktop_config.json`
Claude Desktop (Windows)	`%APPDATA%\Claude\claude_desktop_config.json`
Cline (VS Code)	VS Code Settings → Cline → MCP Servers (or `.vscode/cline_mcp_settings.json`)
VS Code (native MCP)	`.vscode/mcp.json` in workspace root
Cursor	Cursor Settings → MCP → Add Server

📖 VS Code Integration Guide → — step-by-step setup for Cline, Continue, and VS Code native MCP with example configs.

Optional: OpenRouter Full Mode (legacy)

If you want the server to make its own AI calls (bypassing the host LLM), add an OpenRouter API key:

json

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

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

Sign up at OpenRouter.ai/keys. This mode is not recommended — CE-MCP produces equivalent results using your existing host LLM context.

Optional: ADR Aggregator integration

json

{  "mcpServers": {    "adr-analysis": {      "command": "mcp-adr-analysis-server",      "env": {        "PROJECT_PATH": "/path/to/your/project",        "ADR_AGGREGATOR_API_KEY": "agg_your_key_here"      }    }  }}

{  "mcpServers": {    "adr-analysis": {      "command": "mcp-adr-analysis-server",      "env": {        "PROJECT_PATH": "/path/to/your/project",        "ADR_AGGREGATOR_API_KEY": "agg_your_key_here"      }    }  }}

Get your API key at adraggregator.com

📖 Full Configuration Guide → | Client Setup →

Execution Modes

	CE-MCP (default)	Full Mode (legacy)	Prompt-Only
Requires API key?	No	Yes (`OPENROUTER_API_KEY`)	No
Returns	Orchestration directives for the host LLM to execute	Server-side AI analysis results	Prompts you can paste into any AI chat
Set via	Default (no env var needed)	`EXECUTION_MODE=full`	`EXECUTION_MODE=prompt-only`
Best for	All users — recommended	Legacy workflows with dedicated API budget	Offline exploration
Tools available	All 63 tools with annotated MCP metadata	All 63 tools	Analysis prompts, templates, local file operations, ADR discovery

What are CE-MCP directives? When a tool is called, it returns a structured orchestration directive that tells your host LLM what to analyze, what data to gather, and how to format results. The host LLM (e.g. Claude in Claude Desktop, or GPT in Cursor) executes the directive using its existing context window. This means zero additional API costs and better results because the LLM already has your conversation context.

🚀 Usage Examples

Just ask your MCP client in natural language — no code required:

"Analyze this React project's architecture and suggest ADRs for any implicit decisions"

"Generate ADRs from the PRD.md file and create a todo.md with implementation tasks"

"Check this codebase for security issues and provide masking recommendations"

The server returns structured analysis and orchestration directives that your host LLM executes in context.

Programmatic Usage (Advanced)

If you're integrating the server into your own tooling via the MCP SDK:

typescript

// Basic project analysisconst analysis = await analyzeProjectEcosystem({  projectPath: '/path/to/project',  analysisType: 'comprehensive',});
// Generate ADRs from requirementsconst adrs = await generateAdrsFromPrd({  prdPath: 'docs/PRD.md',  outputDirectory: 'docs/adrs',});
// Smart Code Linking - Find code related to ADR decisionsconst relatedCode = await findRelatedCode(  'docs/adrs/001-auth-system.md',  'We will implement JWT authentication with Express middleware',  '/path/to/project',  {    useRipgrep: true, // Fast text search    maxFiles: 10, // Limit results    includeContent: true, // Include file contents  });

// Basic project analysisconst analysis = await analyzeProjectEcosystem({  projectPath: '/path/to/project',  analysisType: 'comprehensive',});
// Generate ADRs from requirementsconst adrs = await generateAdrsFromPrd({  prdPath: 'docs/PRD.md',  outputDirectory: 'docs/adrs',});
// Smart Code Linking - Find code related to ADR decisionsconst relatedCode = await findRelatedCode(  'docs/adrs/001-auth-system.md',  'We will implement JWT authentication with Express middleware',  '/path/to/project',  {    useRipgrep: true, // Fast text search    maxFiles: 10, // Limit results    includeContent: true, // Include file contents  });

📖 Complete Usage Guide → | API Reference →

Try it out: This repo includes a sample-project/ directory with example ADRs and source code. Point PROJECT_PATH at it to experiment without affecting your own codebase.

Note: The sample project is only available when cloning from source (Option 3 above). If you installed via npm (Option 1 or 2), create your own test project or clone the repo separately to access the sample: git clone --depth 1 https://github.com/tosin2013/mcp-adr-analysis-server.git sample-test

🎯 Use Cases

👨‍💻 AI Coding Assistants - Enhance Claude, Cline, Cursor with architectural intelligence
💬 Conversational AI - Answer architecture questions with confidence scoring
🤖 Autonomous Agents - Continuous analysis and rule enforcement
🏢 Enterprise Teams - Portfolio analysis and migration planning

📖 Detailed Use Cases →

🛠️ Technology Stack

Runtime: Node.js 20+ • Language: TypeScript • Framework: MCP SDK • Testing: Vitest (~49% statements, enforced floor) Search: ripgrep (fast recursive text search) + fast-glob (file matching) • AI Integration: CE-MCP orchestration directives (host LLM) • Code Analysis: tree-sitter (incremental code parser) + Smart Code Linking

📖 Technical Details → | CE-MCP Migration Playbook →

📁 Project Structure

src/tools/     # 64 MCP tools with annotated metadatadocs/adrs/     # Architectural Decision Recordstests/         # ~49% statement coverage, floor enforced in CI.github/       # CI/CD automation

src/tools/     # 64 MCP tools with annotated metadatadocs/adrs/     # Architectural Decision Recordstests/         # ~49% statement coverage, floor enforced in CI.github/       # CI/CD automation

📖 Full Structure →

🧪 Testing

📖 Testing Guide →

🌐 ADR Aggregator Integration (Optional)

ADR Aggregator is a platform for cross-team ADR visibility and governance. It provides:

Cross-repository knowledge graphs — See how architectural decisions relate across projects
Governance dashboards — Track ADR compliance, staleness, and review cycles
Template library — Access domain-specific ADR templates (security, API, database, etc.)
Team collaboration — Share architectural decisions organization-wide

Note: ADR Aggregator is optional. All core analysis features work without it.

bash

# Set your API key (get one at adraggregator.com)export ADR_AGGREGATOR_API_KEY="agg_your_key_here"

# Set your API key (get one at adraggregator.com)export ADR_AGGREGATOR_API_KEY="agg_your_key_here"

Available Tools

Tool	Description	Free	Pro+	Team
`sync_to_aggregator`	Push local ADRs to platform	✅	✅	✅
`get_adr_context`	Pull ADR context from platform	✅	✅	✅
`get_staleness_report`	Get ADR governance/health reports	✅	✅	✅
`get_adr_templates`	Retrieve domain-specific templates	✅	✅	✅
`get_adr_diagrams`	Get Mermaid diagrams for ADRs	—	✅	✅
`validate_adr_compliance`	Validate ADR implementation	—	✅	✅
`get_knowledge_graph`	Cross-repository knowledge graph	—	—	✅

Workflow for New Repos

bash

# 1. Analyze codebase for implicit architectural decisionssuggest_adrs(analysisType: 'implicit_decisions')
# 2. Generate ADR files from suggestionsgenerate_adr_from_decision(decisionData)
# 3. Save ADRs to docs/adrs/
# 4. (Optional) Sync to adraggregator.comsync_to_aggregator(full_sync: true)

# 1. Analyze codebase for implicit architectural decisionssuggest_adrs(analysisType: 'implicit_decisions')
# 2. Generate ADR files from suggestionsgenerate_adr_from_decision(decisionData)
# 3. Save ADRs to docs/adrs/
# 4. (Optional) Sync to adraggregator.comsync_to_aggregator(full_sync: true)

Benefits: Cross-team visibility • Staleness alerts • Compliance tracking • Organization-wide knowledge graph

📖 ADR Aggregator Guide → | 📖 MCP Integration Guide →

🔧 Development

bash

git clone https://github.com/tosin2013/mcp-adr-analysis-server.gitcd mcp-adr-analysis-servernpm install && npm run build && npm test

git clone https://github.com/tosin2013/mcp-adr-analysis-server.gitcd mcp-adr-analysis-servernpm install && npm run build && npm test

Quality Standards: TypeScript strict mode • ESLint • enforced coverage floor • Pre-commit hooks

Viewing Documentation Locally

API documentation is generated with TypeDoc:

bash

npm install          # Required once after cloning (installs typedoc)npm run docs:build   # Generate API docs into docs/api/npm run docs:serve   # Serve locally via Python HTTP server

npm install          # Required once after cloning (installs typedoc)npm run docs:build   # Generate API docs into docs/api/npm run docs:serve   # Serve locally via Python HTTP server

Then open http://localhost:8080 in your browser. Markdown documentation lives in docs/ and can be browsed directly on GitHub.

📖 Development Guide → | Contributing →

🔧 Troubleshooting

Common Issues:

RHEL Systems: Use special installer script
Tools return directives instead of results: This is expected in CE-MCP mode — your host LLM executes the directives. For server-side execution, set EXECUTION_MODE=full + OPENROUTER_API_KEY
Module not found: Run npm install && npm run build
Permission denied: Check file permissions and project path

📖 Complete Troubleshooting Guide →

🔒 Security & Performance

Security: Automatic secret detection • Content masking • Local processing • Zero trust
Performance: Multi-level caching • Incremental analysis • Parallel processing • Memory optimization

📖 Security Guide → | Performance →

🔐 Security Vulnerability Reporting

Found a security issue? Please read our Security Policy for responsible disclosure procedures. Do not create public issues for security vulnerabilities.

🤝 Contributing

We welcome contributions! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated.

🌟 Quick Start for Contributors

Fork the repository
Clone your fork: git clone https://github.com/YOUR_USERNAME/mcp-adr-analysis-server.git
Create a branch: git checkout -b feature/your-feature-name
Make your changes with tests
Test: npm test (do not drop below the coverage floor)
Submit a Pull Request

🗺️ Roadmap

Work is tracked in GitHub milestones, and milestone membership is what marks an issue as admitted.

Architectural direction lives in docs/adrs/; release cadence is in RELEASES.md.

👶 First Time Contributing?

Looking for a good first issue? Check out our good first issues - these are beginner-friendly tasks perfect for getting started!

New to open source? Our Contributing Guide walks you through the entire process step-by-step.

📝 Reporting Issues

Use our issue templates when reporting bugs or requesting features. Templates help us understand and resolve issues faster.

Standards: TypeScript strict • enforced coverage floor • ESLint • Security validation • MCP compliance

📖 Full Contributing Guide → | Code of Conduct →

🔗 Resources

Official: MCP Specification • MCP SDK
Community: MCP Registry • Discord
Project: ADRs • Progress • Publishing Guide

📄 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

Anthropic for creating the Model Context Protocol
The MCP Community for inspiration and best practices
Contributors who help make this project better

Built with ❤️ by Tosin Akinosho for AI-driven architectural analysis

Empowering AI assistants with drift detection, content safety, and decision memory via CE-MCP orchestration directives.

Source: README.md at commit 0d4c15b

Tools

analyze_project_ecosystem

Analyze Project Ecosystem

Comprehensive recursive project ecosystem analysis with advanced prompting techniques (Knowledge Generation + Reflexion)

ParametersprojectPathenhancedModeanalysisDepthanalysisScoperecursiveDepthincludePatternslearningEnabledtechnologyFocusincludeEnvironmentknowledgeEnhancement

get_architectural_context

Get Architectural Context

Get detailed architectural context for specific files or the entire project, automatically sets up ADR infrastructure if missing, and provides outcome-focused workflow for project success

ParametersfilePathincludeCompliance

generate_adrs_from_prd

Generate ADRs from PRD

Generate Architectural Decision Records from a Product Requirements Document with advanced prompting techniques (APE + Knowledge Generation)

ParametersprdPathrequiredprdTypeenhancedModeoutputDirectorypromptOptimizationknowledgeEnhancement

compare_adr_progress

Compare ADR Progress

Compare TODO.md progress against ADRs and current environment to validate implementation status

ParameterstodoPathstrictModeenvironmentprojectPathadrDirectoryvalidationTypedeepCodeAnalysisenvironmentConfigincludeFileChecksfunctionalValidationenvironmentValidationincludeRuleValidation

analyze_content_security

Analyze Content Security

Analyze content for sensitive information using AI-powered detection with optional memory integration for security pattern learning

ParameterscontentrequiredcontentTypeenhancedModeuserDefinedPatternsknowledgeEnhancementenableMemoryIntegration

generate_content_masking

Generate Content Masking

Generate masking instructions for detected sensitive content

ParameterscontentrequireddetectedItemsrequiredmaskingStrategy

configure_custom_patterns

Configure Custom Patterns

Configure custom sensitive patterns for a project

ParametersprojectPathrequiredexistingPatterns

apply_basic_content_masking

Apply Basic Content Masking

Apply basic content masking (fallback when AI is not available)

ParameterscontentrequiredmaskingStrategy

validate_content_masking

Validate Content Masking

Validate that content masking was applied correctly

ParametersmaskedContentrequiredoriginalContentrequired

manage_cache

Manage Cache

Manage MCP resource cache (clear, stats, cleanup)

Parameterskeyactionrequired

configure_output_masking

Configure Output Masking

Configure content masking for all MCP outputs

ParametersactionenabledstrategycustomPatterns

suggest_adrs

Suggest ADRs

Suggest architectural decisions with advanced prompting techniques (Knowledge Generation + Reflexion). TIP: Read @.mcp-server-context.md first for project history, patterns, and previous ADRs to ensure consistency.

ParametersafterCodebeforeCodeprojectPathanalysisTypeenhancedModeexistingAdrscommitMessageslearningEnabledchangeDescriptionconversationContextknowledgeEnhancement

generate_adr_from_decision

Generate ADR from Decision

Generate a complete ADR from decision data. TIP: Reference @.mcp-server-context.md to align with existing architectural patterns and decisions.

ParametersadrDirectorydecisionDatarequiredexistingAdrstemplateFormat

generate_adr_bootstrap

Generate ADR Bootstrap

Generate bootstrap.sh and validate_bootstrap.sh scripts to ensure deployed code follows ADR requirements. **CRITICAL**: Before generating scripts, use WebFetch to query the base code repository (e.g., https://github.com/validatedpatterns/common for OpenShift) and authoritative pattern documentation (e.g., https://play.validatedpatterns.io/). Merge the base repository code into your project and have bootstrap.sh call the pattern's scripts rather than generating everything from scratch. This ensures compliance with validated deployment patterns.

ParametersoutputPathscriptTypeprojectPathadrDirectoryincludeTestscustomValidationsincludeDeployment

bootstrap_validation_loop

Bootstrap Validation Loop

**GUIDED EXECUTION MODE**: This tool guides you through an interactive, step-by-step deployment validation workflow. It does NOT execute commands internally - instead, it tells YOU what commands to run and processes the results iteratively. **Workflow**: (1) First call with iteration=0: Detects platform (OpenShift/K8s/Docker), validates environment connection, and requests human approval for target platform. (2) Subsequent calls: After running each command and reporting back with output, the tool provides next steps. **Environment Validation**: Before deployment, the tool verifies connection to the target platform (e.g., `oc status` for OpenShift, `kubectl cluster-info` for K8s) and requires explicit human confirmation. **Validated Patterns Integration**: Automatically identifies base code repositories (e.g., validatedpatterns/common for OpenShift) and guides you to merge them into your project. **Deployment Cleanup**: Supports CI/CD-style workflows with deployment teardown/restart guidance. **Call this tool iteratively**, passing previous command output back each time.

ParametersautoFixappSelectorprojectPathadrDirectorymaxIterationscurrentIterationtargetEnvironmentpreviousExecutionOutputupdateAdrsWithLearningspreviousExecutionSuccessdeploymentCleanupRequested

discover_existing_adrs

Discover Existing ADRs

Discover and catalog existing ADRs in the project

ParametersadrDirectoryincludeContent

analyze_adr_timeline

Analyze ADR Timeline

Analyze ADR timeline with smart time tracking, adaptive thresholds, and actionable recommendations. Auto-detects project context (startup/growth/mature) and generates prioritized work queue based on staleness, implementation lag, and technical debt.

ParametersprojectPathadrDirectoryforceExtractincludeContentgenerateActionsthresholdProfileautoDetectContext

review_existing_adrs

Review Existing ADRs

Review existing ADRs against actual code implementation with cloud/DevOps expertise. TIP: After review, call get_server_context to update @.mcp-server-context.md with findings.

ParametersprojectPathspecificAdradrDirectoryanalysisDepthincludeTreeSittergenerateUpdatePlan

validate_adr

Validate ADR

Validate an existing ADR against actual infrastructure reality using research-driven analysis. TIP: Compare findings against patterns in @.mcp-server-context.md for consistency checks.

ParametersadrPathrequiredprojectPathadrDirectoryconfidenceThresholdincludeEnvironmentCheck

validate_all_adrs

Validate All ADRs

Validate all ADRs in a directory against actual infrastructure reality

ParametersprojectPathadrDirectoryminConfidenceincludeEnvironmentCheck

incorporate_research

Incorporate Research

Incorporate research findings into architectural decisions

ParametersadrIdupdateTypeadrDirectoryanalysisTyperesearchPathexistingTopicsresearchTopicsresearchFindings

create_research_template

Create Research Template

Create a research template file for documenting findings

ParameterstitlerequiredcategoryresearchPath

request_action_confirmation

Request Action Confirmation

Request confirmation before applying research-based changes

Parametersactionrequiredimpactdetailsrequired

generate_rules

Generate Rules

Generate architectural rules from ADRs and code patterns

ParameterssourceprojectPathadrDirectoryoutputFormatexistingRules

validate_rules

Validate Rules

Validate code against architectural rules

ParametersrulesrequiredfileNamefilePathfileContentreportFormatvalidationType

create_rule_set

Create Rule Set

Create machine-readable rule set in JSON/YAML format

ParametersnamerequiredrulesauthoradrRulesdescriptionoutputFormatpatternRules

analyze_environment

Analyze Environment

Analyze environment context and provide optimization recommendations with optional memory integration for environment snapshot tracking

ParametersprojectPathadrDirectoryanalysisTyperequirementsindustryStandardscurrentEnvironmentenableTrendAnalysisenableMemoryIntegration

generate_research_questions

Generate Research Questions

Generate context-aware research questions and create research tracking system

ParametersproblemsprojectPathadrDirectoryanalysisTypeknowledgeGraphcurrentProgressresearchContextrelevantKnowledgeresearchQuestions

perform_research

Perform Research

Perform research using cascading sources: project files → session/tool-usage tracker → environment resources → web search (fallback)

ParametersquestionrequiredprojectPathadrDirectoryperformWebSearchresearchDirectoryconfidenceThreshold

search_codebase

Search Codebase

Atomic tool for searching codebase files based on query patterns. Returns raw file matches with relevance scores. Extracted from ResearchOrchestrator per ADR-018.

ParametersqueryrequiredscopemaxFilesprojectPathincludeContentenableTreeSitterrelevanceThreshold

analyze_deployment_progress

Analyze Deployment Progress

Analyze deployment progress and verify completion with outcome rules

ParameterscicdLogstodoPathcicdStatusadrDirectoryanalysisTypeoutcomeRulesactualOutcomespipelineConfigdeploymentTasksenvironmentStatus

get_workflow_guidance

Get Workflow Guidance

Get intelligent workflow guidance and tool recommendations based on your goals and project context to achieve expected outcomes efficiently

ParametersgoalrequiredtimeframeprojectContextrequiredavailableAssetsprimaryConcerns

get_development_guidance

Get Development Guidance

Get comprehensive development guidance that translates architectural decisions and workflow recommendations into specific coding tasks, implementation patterns, and development roadmap

ParameterstimelinefocusAreasteamContextadrsToImplementcurrentProgresstechnologyStackdevelopmentPhaserequired

generate_deployment_guidance

Generate Deployment Guidance

Generate deployment guidance and instructions from ADRs with environment-specific configurations

ParametersformatenvironmentprojectPathadrDirectorygenerateFilesincludeConfigsincludeScriptsincludeRollbacktechnologyFilterincludeValidationcustomRequirements

smart_git_push

Smart Git Push

AI-driven security-focused git push with credential detection, file filtering, and deployment metrics tracking. Tests should be run by calling AI and results provided.

ParametersbranchdryRunmessageforceUnsafeprojectPathtestResultsskipSecurity

deployment_readiness

Check Deployment Readiness

Comprehensive deployment readiness validation with test failure tracking, deployment history analysis, and hard blocking for unsafe deployments. Integrates with smart_git_push for deployment gating.

ParametersoperationrequiredstrictModeprojectPathallowMockCodeemergencyBypassmaxTestFailuresapprovalRequiredmaxRecentFailurestargetEnvironmenttestSuiteRequiredintegrateTodoTasksmockCodeMaxAllowed+12 more

release_tracking

Track Releases

Track releases mapped to ADR decisions. Generates changelogs, manages milestones, compares releases, and assesses release readiness. Supports greenfield and brownfield projects. Writes CHANGELOG.md, creates GitHub Releases and Milestones.

ParametersformatversioncompareTolocalOnlyoperationrequiredgroupByAdrupdateTodocompareFromprojectPathwriteToFilemilestoneTitleincludeAdrLinks+9 more

generate_adr_todo

Generate ADR Todo

Generate TODO.md from ADRs with comprehensive task breakdown. Decomposes each ADR into paired test+production tasks (TDD), links tasks to release milestones, and preserves manual edits via a bounded HTML-comment section. Re-runs are idempotent; tasks for deleted/superseded ADRs move to a Stale Tasks section.

ParametersphasescopedryRuntodoPathprojectPathadrDirectorylinkToMilestones

troubleshoot_guided_workflow

Troubleshoot Guided Workflow

Structured failure analysis and test plan generation with memory integration for troubleshooting session tracking and intelligent ADR/research suggestion capabilities - provide JSON failure info to get specific test commands

ParametersfailuretodoPathoperationrequiredprojectPathadrDirectoryenableAdrSuggestionenableMemoryIntegrationenablePatternRecognitionenableResearchGeneration

smart_score

Smart Score

Central coordination for project health scoring system - recalculate, sync, diagnose, optimize, and reset scores across all MCP tools

ParametersintentIdtodoPathcomponentoperationrequiredcomponentsforceUpdatepreviewOnlyprojectPathrequiredanalysisModetriggerToolscustomWeightsupdateSources+6 more

mcp_planning

MCP Planning

Enhanced project planning and workflow management tool - phase-based project management, team resource allocation, progress tracking, risk analysis, and executive reporting

ParametersteamactionformatphasesphaseIdmemberIdoperationrequiredphaseDatatimeframememberDatareportTypedescription+14 more

interactive_adr_planning

Interactive ADR Planning

Interactive guided ADR planning and creation tool - walks users through structured decision-making process with research integration, option evaluation, and automatic ADR generation. TIP: Start by reading @.mcp-server-context.md to understand project context and previous decisions.

ParametersinputoperationrequiredsessionIdprojectPathrequiredautoResearchgenerateTodos

memory_loading

Load Memory

Advanced memory loading tool for the memory-centric architecture. Query, explore, and manage memory entities and relationships. Load ADRs into memory system and perform intelligent queries.

ParametersqueryactionentityIdmaxDepthforceReload

expand_analysis_section

Expand Analysis Section

Retrieve full analysis content from tiered responses. Expand entire analysis or specific sections stored in memory. Use this when a tool returns a summary with an expandable ID.

ParametersformatsectionexpandableIdrequired

tool_chain_orchestrator

Tool Chain Orchestrator

AI-powered dynamic tool sequencing - intelligently analyze user requests and generate structured tool execution plans

ParametersmaxStepsuserRequestrequiredcontextHintsallowParallelexecutionModeavailableTools

expand_memory

Expand Memory

Phase 3: Retrieve and expand stored content from a tiered response using its expandable ID

ParameterssectionexpandableIdrequiredincludeContext

query_conversation_history

Query Conversation History

Phase 3: Search and retrieve conversation sessions based on filters

ParameterslimitkeyworddateRangetoolsUsedprojectPath

get_conversation_snapshot

Get Conversation Snapshot

Phase 3: Get current conversation context snapshot for resumption or analysis

ParametersrecentTurnCount

get_memory_stats

Get Memory Stats

Phase 3: Get statistics about stored conversation memory

Takes no parameters.

update_knowledge

Update Knowledge

ADR-018: Simple CRUD operations for project session state. Not a graph database — keyword retrieval over local JSON snapshots. Add/remove entities (intents, ADRs, tools, code) and relationships. Use knowledge://graph resource to read current state (zero token cost).

ParametersentitysourcetargetmetadataoperationrequiredentityTyperelationship

get_server_context

Get Server Context

Generate a comprehensive context file showing the server's current state, memory, and capabilities. Creates .mcp-server-context.md that can be @ referenced in conversations for instant LLM awareness

ParametersoutputPathwriteToFilemaxRecentItemsincludeDetailed

set_project_path

Set Project Path

Dynamically set the active project path for the current session. Call this at the start of a session to switch between projects without restarting the server or modifying environment variables. All subsequent tool calls will use this path as the default.

ParameterspathrequiredvalidatePath

sync_to_aggregator

Sync to Aggregator

Sync ADRs to ADR Aggregator platform (https://adraggregator.com) for centralized tracking, visualization, and team collaboration. Supports incremental and full sync modes with optional metadata.

Parametersadr_pathsfull_syncprojectPathinclude_diagramsinclude_metadatainclude_timelineinclude_code_linksinclude_security_scan

get_adr_context

Get ADR Context

Fetch ADR context from ADR Aggregator including summaries, diagrams, timeline data, and code links. Useful for getting a consolidated view of architectural decisions.

Parametersgraph_depthprojectPathinclude_diagramsinclude_researchinclude_timelinestaleness_filterinclude_code_links

get_staleness_report

Get Staleness Report

Get ADR staleness report from ADR Aggregator with review compliance metrics. Identifies stale ADRs that need attention and provides governance insights.

ParametersthresholdprojectPath

get_adr_templates

Get ADR Templates

Get domain-specific ADR templates and anti-patterns from ADR Aggregator. Includes best practices for web applications, microservices, APIs, and more. No authentication required.

Parametersdomain

get_adr_diagrams

Get ADR Diagrams

Get Mermaid diagrams for ADRs from ADR Aggregator. Includes workflow, relationship, and impact diagrams. Requires Pro+ tier.

Parametersadr_pathprojectPath

validate_adr_compliance

Validate ADR Compliance

Validate ADR compliance against implementation via ADR Aggregator. Checks that code actually implements documented decisions. Requires Pro+ tier.

Parametersadr_pathsprojectPathvalidation_type

get_knowledge_graph

Get Knowledge Graph

Get cross-repository knowledge graph from ADR Aggregator with analytics and insights. Visualize ADR relationships across repositories. Requires Team tier.

ParametersscopeprojectPathinclude_analytics

update_implementation_status

Update Implementation Status

Update the implementation status of synced ADRs directly from the IDE. Supports statuses: not_started, in_progress, implemented, deprecated, blocked. Requires Pro+ tier.

ParametersupdatesrequiredprojectPath

get_adr_priorities

Get ADR Priorities

Get ADR priorities for roadmap and backlog planning from ADR Aggregator. Returns prioritized ADRs with scores, dependencies, blockers, implementation status, and gap counts.

Parametersinclude_aiprojectPath

analyze_gaps

Analyze Gaps

Scan local codebase and compare with ADRs to detect bi-directional gaps. Finds: (1) ADR-to-code gaps: file references in ADRs that do not exist, (2) Code-to-ADR gaps: technologies in package.json and architectural patterns without ADR coverage. Reports gaps to ADR Aggregator for tracking.

ParametersprojectPathexcludePatternsincludePatternsscanDirectoriesincludeDismissedreportToAggregator

get_gaps

Get Gaps

Get current code gaps from ADR Aggregator. Returns gaps with their status (open, dismissed, resolved) for tracking and management.

ParametersprojectPathincludeResolvedincludeDismissed

Version history

v2.14.19LatestOct 29, 2026
v2.14.13Sep 17, 2026
v2.14.8Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listedRequired15 pts
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

Mcp Adr Analysis Server

Overview

Installation

In SourceWeft

Other MCP clients

README

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

Table of contents

What is MCP?

TL;DR

✨ Core Capabilities

Prerequisites

Network Requirements

📦 Quick Installation

⚡ Quick Setup (2 Steps)

Execution Modes

🚀 Usage Examples

🎯 Use Cases

🛠️ Technology Stack

📁 Project Structure

🧪 Testing

🌐 ADR Aggregator Integration (Optional)

Available Tools

Workflow for New Repos

🔧 Development

Viewing Documentation Locally

🔧 Troubleshooting

🔒 Security & Performance

🔐 Security Vulnerability Reporting

🤝 Contributing

🌟 Quick Start for Contributors

🗺️ Roadmap

👶 First Time Contributing?

📝 Reporting Issues

🔗 Resources

📄 License

🙏 Acknowledgments

Tools

analyze_project_ecosystem

get_architectural_context

generate_adrs_from_prd

compare_adr_progress

analyze_content_security

generate_content_masking

configure_custom_patterns

apply_basic_content_masking

validate_content_masking

manage_cache

configure_output_masking

suggest_adrs

generate_adr_from_decision

generate_adr_bootstrap

bootstrap_validation_loop

discover_existing_adrs

analyze_adr_timeline

review_existing_adrs

validate_adr

validate_all_adrs

incorporate_research

create_research_template

request_action_confirmation

generate_rules

validate_rules

create_rule_set

analyze_environment

generate_research_questions

perform_research

search_codebase

analyze_deployment_progress

get_workflow_guidance

get_development_guidance

generate_deployment_guidance

smart_git_push

deployment_readiness

release_tracking

generate_adr_todo

troubleshoot_guided_workflow

smart_score

mcp_planning

interactive_adr_planning