Mcp Adr Analysis Server

io.github.tosin2013由 GitHub 账号 tosin2013 发布v2.14.19更新于 Nov 3, 2026

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

概览

AI 生成的概览

本地 MCP 服务器,用实际代码校验架构决策记录(ADR),并支持敏感内容脱敏与跨会话决策记忆。

可以做什么
  • 分析项目与代码库:生态分析、架构上下文、代码库搜索、技术栈与环境识别
  • 管理 ADR:发现、建议、从 PRD 或决策数据生成、评审、对照基础设施校验、分析时间线
  • 把决策转成工作:生成 TODO.md 任务拆分、架构规则与规则集、部署指引、发布跟踪
  • 内容安全:检测敏感内容、生成并应用脱敏、配置自定义模式与输出脱敏
  • 部署与流程:就绪检查、引导式 bootstrap 校验、带凭据检测的 git push、工作流与排障指引、健康评分
适用场景
适合在维护 ADR 的代码仓库中工作的团队和 AI 编程助手,用于发现过时或未落实的架构决策、根据需求生成新 ADR,或在内容离开本机前筛查密钥等敏感信息。
运行要求
以 npm 包形式通过 stdio 在本机运行;需要 Node.js 20 及以上、npm 9 及以上,以及兼容 MCP 的客户端。安装时需联网编译 tree-sitter 原生模块,失败时进入功能精简模式。可选环境变量:PROJECT_PATH、ADR_DIRECTORY、EXECUTION_MODE,仅 full 模式需要 OPENROUTER_API_KEY。
安装前请注意
full 执行模式会把分析发送到 OpenRouter,需要 OPENROUTER_API_KEY 并产生 API 费用,README 称该模式不推荐。多个工具会写入项目:ADR 文件、TODO.md、CHANGELOG.md、规则集、bootstrap 脚本,以及 GitHub Release 与里程碑。smart_git_push 会推送代码,部署就绪检查可能阻止部署。可选的 ADR Aggregator 密钥会把 ADR 同步到第三方 SaaS。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Adr Analysis Server,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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.

Table of contents

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
TermDefinition
ADRArchitectural Decision Record — A document that captures an important architectural decision along with its context, alternatives considered, and consequences.
MCPModel Context Protocol — An open standard enabling AI assistants to connect to external tools and data sources.
CE-MCPClaude-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-sitterAn 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 TrackerProject-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 LinkingDiscovery of code files related to ADRs and architectural decisions, using keyword extraction and ripgrep search.
ADR AggregatorOptional 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+)

Required:

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

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)

  1. Install: npm install -g mcp-adr-analysis-server
  2. 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"      }    }  }}

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
ClientConfig 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
CursorCursor 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"      }    }  }}

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"      }    }  }}

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?NoYes (OPENROUTER_API_KEY)No
ReturnsOrchestration directives for the host LLM to executeServer-side AI analysis resultsPrompts you can paste into any AI chat
Set viaDefault (no env var needed)EXECUTION_MODE=fullEXECUTION_MODE=prompt-only
Best forAll users — recommendedLegacy workflows with dedicated API budgetOffline exploration
Tools availableAll 63 tools with annotated MCP metadataAll 63 toolsAnalysis 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  });

📖 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

📖 Full Structure →

🧪 Testing

bash
npm test              # Run all testsnpm run test:coverage # Coverage report

📖 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"

Available Tools

ToolDescriptionFreePro+Team
sync_to_aggregatorPush local ADRs to platform✅✅✅
get_adr_contextPull ADR context from platform✅✅✅
get_staleness_reportGet ADR governance/health reports✅✅✅
get_adr_templatesRetrieve domain-specific templates✅✅✅
get_adr_diagramsGet Mermaid diagrams for ADRs—✅✅
validate_adr_complianceValidate ADR implementation—✅✅
get_knowledge_graphCross-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)

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

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

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

  1. Fork the repository
  2. Clone your fork: git clone https://github.com/YOUR_USERNAME/mcp-adr-analysis-server.git
  3. Create a branch: git checkout -b feature/your-feature-name
  4. Make your changes with tests
  5. Test: npm test (do not drop below the coverage floor)
  6. 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.

来源:README.md,提交 0d4c15b

工具

63

analyze_project_ecosystem

Analyze Project Ecosystem

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

输入参数projectPathenhancedModeanalysisDepthanalysisScoperecursiveDepthincludePatternslearningEnabledtechnologyFocusincludeEnvironmentknowledgeEnhancement

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

输入参数filePathincludeCompliance

generate_adrs_from_prd

Generate ADRs from PRD

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

输入参数prdPath必填prdTypeenhancedModeoutputDirectorypromptOptimizationknowledgeEnhancement

compare_adr_progress

Compare ADR Progress

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

输入参数todoPathstrictModeenvironmentprojectPathadrDirectoryvalidationTypedeepCodeAnalysisenvironmentConfigincludeFileChecksfunctionalValidationenvironmentValidationincludeRuleValidation

analyze_content_security

Analyze Content Security

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

输入参数content必填contentTypeenhancedModeuserDefinedPatternsknowledgeEnhancementenableMemoryIntegration

generate_content_masking

Generate Content Masking

Generate masking instructions for detected sensitive content

输入参数content必填detectedItems必填maskingStrategy

configure_custom_patterns

Configure Custom Patterns

Configure custom sensitive patterns for a project

输入参数projectPath必填existingPatterns

apply_basic_content_masking

Apply Basic Content Masking

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

输入参数content必填maskingStrategy

validate_content_masking

Validate Content Masking

Validate that content masking was applied correctly

输入参数maskedContent必填originalContent必填

manage_cache

Manage Cache

Manage MCP resource cache (clear, stats, cleanup)

输入参数keyaction必填

configure_output_masking

Configure Output Masking

Configure content masking for all MCP outputs

输入参数actionenabledstrategycustomPatterns

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.

输入参数afterCodebeforeCodeprojectPathanalysisTypeenhancedModeexistingAdrscommitMessageslearningEnabledchangeDescriptionconversationContextknowledgeEnhancement

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.

输入参数adrDirectorydecisionData必填existingAdrstemplateFormat

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.

输入参数outputPathscriptTypeprojectPathadrDirectoryincludeTestscustomValidationsincludeDeployment

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.

输入参数autoFixappSelectorprojectPathadrDirectorymaxIterationscurrentIterationtargetEnvironmentpreviousExecutionOutputupdateAdrsWithLearningspreviousExecutionSuccessdeploymentCleanupRequested

discover_existing_adrs

Discover Existing ADRs

Discover and catalog existing ADRs in the project

输入参数adrDirectoryincludeContent

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.

输入参数projectPathadrDirectoryforceExtractincludeContentgenerateActionsthresholdProfileautoDetectContext

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.

输入参数projectPathspecificAdradrDirectoryanalysisDepthincludeTreeSittergenerateUpdatePlan

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.

输入参数adrPath必填projectPathadrDirectoryconfidenceThresholdincludeEnvironmentCheck

validate_all_adrs

Validate All ADRs

Validate all ADRs in a directory against actual infrastructure reality

输入参数projectPathadrDirectoryminConfidenceincludeEnvironmentCheck

incorporate_research

Incorporate Research

Incorporate research findings into architectural decisions

输入参数adrIdupdateTypeadrDirectoryanalysisTyperesearchPathexistingTopicsresearchTopicsresearchFindings

create_research_template

Create Research Template

Create a research template file for documenting findings

输入参数title必填categoryresearchPath

request_action_confirmation

Request Action Confirmation

Request confirmation before applying research-based changes

输入参数action必填impactdetails必填

generate_rules

Generate Rules

Generate architectural rules from ADRs and code patterns

输入参数sourceprojectPathadrDirectoryoutputFormatexistingRules

validate_rules

Validate Rules

Validate code against architectural rules

输入参数rules必填fileNamefilePathfileContentreportFormatvalidationType

create_rule_set

Create Rule Set

Create machine-readable rule set in JSON/YAML format

输入参数name必填rulesauthoradrRulesdescriptionoutputFormatpatternRules

analyze_environment

Analyze Environment

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

输入参数projectPathadrDirectoryanalysisTyperequirementsindustryStandardscurrentEnvironmentenableTrendAnalysisenableMemoryIntegration

generate_research_questions

Generate Research Questions

Generate context-aware research questions and create research tracking system

输入参数problemsprojectPathadrDirectoryanalysisTypeknowledgeGraphcurrentProgressresearchContextrelevantKnowledgeresearchQuestions

perform_research

Perform Research

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

输入参数question必填projectPathadrDirectoryperformWebSearchresearchDirectoryconfidenceThreshold

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.

输入参数query必填scopemaxFilesprojectPathincludeContentenableTreeSitterrelevanceThreshold

analyze_deployment_progress

Analyze Deployment Progress

Analyze deployment progress and verify completion with outcome rules

输入参数cicdLogstodoPathcicdStatusadrDirectoryanalysisTypeoutcomeRulesactualOutcomespipelineConfigdeploymentTasksenvironmentStatus

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

输入参数goal必填timeframeprojectContext必填availableAssetsprimaryConcerns

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

输入参数timelinefocusAreasteamContextadrsToImplementcurrentProgresstechnologyStackdevelopmentPhase必填

generate_deployment_guidance

Generate Deployment Guidance

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

输入参数formatenvironmentprojectPathadrDirectorygenerateFilesincludeConfigsincludeScriptsincludeRollbacktechnologyFilterincludeValidationcustomRequirements

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.

输入参数branchdryRunmessageforceUnsafeprojectPathtestResultsskipSecurity

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.

输入参数operation必填strictModeprojectPathallowMockCodeemergencyBypassmaxTestFailuresapprovalRequiredmaxRecentFailurestargetEnvironmenttestSuiteRequiredintegrateTodoTasksmockCodeMaxAllowed另有 12 个

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.

输入参数formatversioncompareTolocalOnlyoperation必填groupByAdrupdateTodocompareFromprojectPathwriteToFilemilestoneTitleincludeAdrLinks另有 9 个

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.

输入参数phasescopedryRuntodoPathprojectPathadrDirectorylinkToMilestones

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

输入参数failuretodoPathoperation必填projectPathadrDirectoryenableAdrSuggestionenableMemoryIntegrationenablePatternRecognitionenableResearchGeneration

smart_score

Smart Score

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

输入参数intentIdtodoPathcomponentoperation必填componentsforceUpdatepreviewOnlyprojectPath必填analysisModetriggerToolscustomWeightsupdateSources另有 6 个

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

输入参数teamactionformatphasesphaseIdmemberIdoperation必填phaseDatatimeframememberDatareportTypedescription另有 14 个

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.

输入参数inputoperation必填sessionIdprojectPath必填autoResearchgenerateTodos

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.

输入参数queryactionentityIdmaxDepthforceReload

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.

输入参数formatsectionexpandableId必填

tool_chain_orchestrator

Tool Chain Orchestrator

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

输入参数maxStepsuserRequest必填contextHintsallowParallelexecutionModeavailableTools

expand_memory

Expand Memory

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

输入参数sectionexpandableId必填includeContext

query_conversation_history

Query Conversation History

Phase 3: Search and retrieve conversation sessions based on filters

输入参数limitkeyworddateRangetoolsUsedprojectPath

get_conversation_snapshot

Get Conversation Snapshot

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

输入参数recentTurnCount

get_memory_stats

Get Memory Stats

Phase 3: Get statistics about stored conversation memory

无需输入参数。

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).

输入参数entitysourcetargetmetadataoperation必填entityTyperelationship

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

输入参数outputPathwriteToFilemaxRecentItemsincludeDetailed

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.

输入参数path必填validatePath

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.

输入参数adr_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.

输入参数graph_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.

输入参数thresholdprojectPath

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.

输入参数domain

get_adr_diagrams

Get ADR Diagrams

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

输入参数adr_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.

输入参数adr_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.

输入参数scopeprojectPathinclude_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.

输入参数updates必填projectPath

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.

输入参数include_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.

输入参数projectPathexcludePatternsincludePatternsscanDirectoriesincludeDismissedreportToAggregator

get_gaps

Get Gaps

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

输入参数projectPathincludeResolvedincludeDismissed

版本历史

3
  1. v2.14.19最新Oct 29, 2026
  2. v2.14.13Sep 17, 2026
  3. v2.14.8Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分