Adr Analysis MCP server
ADR drift detection, content safety, and decision memory for architectural decisions
33 stars989 downloads/wk
Reviews
Write oneNobody has reviewed Adr Analysis yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Adr Analysis tools (64, 4 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
analyze_adr_timelineAnalyze 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.
analyze_content_securityAnalyze content for sensitive information using AI-powered detection with optional memory integration for security pattern learning
analyze_deployment_progressAnalyze deployment progress and verify completion with outcome rules
analyze_environmentAnalyze environment context and provide optimization recommendations with optional memory integration for environment snapshot tracking
analyze_gapsScan 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.
analyze_project_ecosystemComprehensive recursive project ecosystem analysis with advanced prompting techniques (Knowledge Generation + Reflexion)
apply_basic_content_maskingApply basic content masking (fallback when AI is not available)
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 targe
compare_adr_progressCompare TODO.md progress against ADRs and current environment to validate implementation status
configure_custom_patternsConfigure custom sensitive patterns for a project
configure_output_maskingConfigure content masking for all MCP outputs
create_research_templatewrite actionCreate a research template file for documenting findings
create_rule_setwrite actionCreate machine-readable rule set in JSON/YAML format
deployment_readinessComprehensive deployment readiness validation with test failure tracking, deployment history analysis, and hard blocking for unsafe deployments. Integrates with smart_git_push for deployment gating.
discover_existing_adrsDiscover and catalog existing ADRs in the project
expand_analysis_sectionRetrieve 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.
expand_memoryPhase 3: Retrieve and expand stored content from a tiered response using its expandable ID
generate_adr_bootstrapGenerate 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 hav
generate_adr_from_decisionGenerate a complete ADR from decision data. TIP: Reference @.mcp-server-context.md to align with existing architectural patterns and decisions.
generate_adr_todoGenerate 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.
generate_adrs_from_prdGenerate Architectural Decision Records from a Product Requirements Document with advanced prompting techniques (APE + Knowledge Generation)
generate_content_maskingGenerate masking instructions for detected sensitive content
generate_deployment_guidanceGenerate deployment guidance and instructions from ADRs with environment-specific configurations
generate_research_questionsGenerate context-aware research questions and create research tracking system
generate_rulesGenerate architectural rules from ADRs and code patterns
get_adr_contextFetch ADR context from ADR Aggregator including summaries, diagrams, timeline data, and code links. Useful for getting a consolidated view of architectural decisions.
get_adr_diagramsGet Mermaid diagrams for ADRs from ADR Aggregator. Includes workflow, relationship, and impact diagrams. Requires Pro+ tier.
get_adr_prioritiesGet ADR priorities for roadmap and backlog planning from ADR Aggregator. Returns prioritized ADRs with scores, dependencies, blockers, implementation status, and gap counts.
get_adr_templatesGet domain-specific ADR templates and anti-patterns from ADR Aggregator. Includes best practices for web applications, microservices, APIs, and more. No authentication required.
get_architectural_contextGet 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
get_conversation_snapshotPhase 3: Get current conversation context snapshot for resumption or analysis
get_development_guidanceGet comprehensive development guidance that translates architectural decisions and workflow recommendations into specific coding tasks, implementation patterns, and development roadmap
get_gapsGet current code gaps from ADR Aggregator. Returns gaps with their status (open, dismissed, resolved) for tracking and management.
get_knowledge_graphGet cross-repository knowledge graph from ADR Aggregator with analytics and insights. Visualize ADR relationships across repositories. Requires Team tier.
get_memory_statsPhase 3: Get statistics about stored conversation memory
get_server_contextGenerate a comprehensive context file showing the server's current state, memory, and capabilities. Creates .mcp-server-context.md that can be @ referenced in conversations to give LLMs instant awareness of the server.
get_staleness_reportGet ADR staleness report from ADR Aggregator with review compliance metrics. Identifies stale ADRs that need attention and provides governance insights.
get_workflow_guidanceGet intelligent workflow guidance and tool recommendations based on your goals and project context to achieve expected outcomes efficiently
incorporate_researchIncorporate research findings into architectural decisions
interactive_adr_planningInteractive 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.
manage_cacheManage MCP resource cache (clear, stats, cleanup)
mcp_planningEnhanced project planning and workflow management tool - phase-based project management, team resource allocation, progress tracking, risk analysis, and executive reporting
memory_loadingAdvanced 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.
perform_researchPerform research using cascading sources: project files → session/tool-usage tracker → environment resources → web search (fallback)
query_conversation_historyPhase 3: Search and retrieve conversation sessions based on filters
release_trackingTrack 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.
request_action_confirmationRequest confirmation before applying research-based changes
review_existing_adrsReview 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.
search_codebaseAtomic tool for searching codebase files based on query patterns. Returns raw file matches with relevance scores. Extracted from ResearchOrchestrator per ADR-018.
search_tools[DEPRECATED host-native, ADR-023] Search and discover available tools by category, keyword, or capability. Use this to find the right tool for a task without loading all tool schemas. Returns lightweight tool metadata by default; use includeSchema:true for full schemas.
set_project_pathDynamically 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.
smart_git_pushAI-driven security-focused git push with credential detection, file filtering, and deployment metrics tracking. Tests should be run by calling AI and results provided.
smart_scoreCentral coordination for project health scoring system - recalculate, sync, diagnose, optimize, and reset scores across all MCP tools
suggest_adrsSuggest 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.
sync_to_aggregatorSync ADRs to ADR Aggregator platform (https://adraggregator.com) for centralized tracking, visualization, and team collaboration. Supports incremental and full sync modes with optional metadata.
tool_chain_orchestratorAI-powered dynamic tool sequencing - intelligently analyze user requests and generate structured tool execution plans
troubleshoot_guided_workflowStructured 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
update_implementation_statuswrite actionUpdate the implementation status of synced ADRs directly from the IDE. Supports statuses: not_started, in_progress, implemented, deprecated, blocked. Requires Pro+ tier.
update_knowledgewrite actionADR-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).
validate_adrValidate an existing ADR against actual infrastructure reality using research-driven analysis. TIP: Compare findings against patterns in @.mcp-server-context.md for consistency checks.
validate_adr_complianceValidate ADR compliance against implementation via ADR Aggregator. Checks that code actually implements documented decisions. Requires Pro+ tier.
validate_all_adrsValidate all ADRs in a directory against actual infrastructure reality
validate_content_maskingValidate that content masking was applied correctly
validate_rulesValidate code against architectural rules
Public scan report
scanner v0.1.9 · 2026-09-19 · same rubric, same numbers if you re-run it
- Code scan323 source files scanned13/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 2 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Findings (1)
- highShell command built from a string (injection risk)
exec.shell-concatdist/src/utils/git-remote-detector.js: … short ? '--short' : ''; return execSync(`git rev-parse ${format} HEAD`, { cwd: projec…
Grade history
- 2026-09-19restoreD → Cscore 65: Shell command built from a string (injection risk)
- 2026-09-19downgradeC → Dscore 46: Shell command built from a string (injection risk); curl | sh in a script
Install directly
Runs npx -y mcp-adr-analysis-server on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mcp-adr-analysis-server -- npx -y mcp-adr-analysis-server
Adr Analysis: common questions
- Is Adr Analysis MCP server safe?
- With care: it is graded C, so read the findings first (65/100). Read the Adr Analysis safety report
- How do I install Adr Analysis?
- It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
- Does Adr Analysis need an API key?
- Yes. The registry entry asks for
OPENROUTER_API_KEY. - Is Adr Analysis maintained?
- The last commit was 2 days ago (2026-09-18). The latest release is v2.14.13.
- What can I use instead of Adr Analysis?
- Servers from other publishers that do the same job: Prism Coder MCP server, State Memory MCP server and DocGuard MCP server. Compare all Adr Analysis alternatives.
Alternatives to Adr Analysis
Same job from other publishers: the closest match first, then the best rated.
- Prism CoderSession memory for coding agents: local-first recall, drift detection, on-device inference.not reviewedEstablishedC
State Memory MCPDeterministic, persistent graph server for tracking workflow state, decisions, and blockers.not reviewedEstablishedA- DocGuardDeterministic doc-drift detection: guard, score, explain, verify-claims and diagnose MCP tools.not reviewedEstablishedA
- Tradememory ProtocolTamper-evident decision audit trail and outcome-weighted memory for AI trading agents.not reviewedEstablishedB