MCP ADR 分析服务器

基于AI的架构分析，用于智能开发工作流。 返回实际分析结果，而不是提示提交到其他地方。

TL;DR

是什么: 提供基于AI的架构决策分析和ADR管理的MCP服务器
谁: AI编码助手（Claude、Cline、Cursor）、企业架构师、开发团队
为什么: 获得即时的架构洞察，而不是提示，具有95%的信心评分
如何: npm install -g mcp-adr-analysis-server → 使用OpenRouter API配置 → 开始分析

关键特性: 树状解析器AST分析 • 安全内容屏蔽 • 测试驱动开发 • 部署准备验证

---

作者: Tosin Akinosho | 仓库: GitHub

什么是MCP？

模型上下文协议使AI助手与外部工具之间的无缝集成成为可能。此服务器增强了AI助手的深度架构分析能力，支持智能代码生成、决策跟踪和开发工作流自动化。

✨ 核心功能

🤖 基于AI的分析 - 通过与OpenRouter.ai集成获得即时架构洞察
🏗️ 技术检测 - 识别任何技术栈和架构模式
📋 ADR管理 - 生成、建议并维护架构决策记录
🔗 智能代码链接 - 基于AI发现与ADR和决策相关的代码文件
🛡️ 安全与合规性 - 自动检测并屏蔽敏感内容
🧪 TDD集成 - 两阶段测试驱动开发，带有验证
🚀 部署准备 - 零容忍测试验证，硬阻塞

📖 查看全部功能 →

📦 快速安装

# 选项1：全局安装（推荐频繁使用）
npm install -g mcp-adr-analysis-server

# 选项2：使用npx（无需安装）
npx mcp-adr-analysis-server

# 选项3：RHEL 9/10系统（特殊安装程序）
curl -sSL https://raw.githubusercontent.com/tosin2013/mcp-adr-analysis-server/main/scripts/install-rhel.sh | bash

📖 详细安装指南 → | RHEL设置 →

⚡ 快速设置（3步）

1. 获取API密钥: OpenRouter.ai/keys
2. 设置环境: OPENROUTER_API_KEY=your_key + EXECUTION_MODE=full
3. 配置客户端: 添加到Claude桌面、Cline、Cursor或Windsurf

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

📖 完整配置指南 → | 客户端设置 →

🚀 使用示例

询问Claude（或其他MCP客户端）:

"分析这个React项目的架构，并为任何隐含的决策提出ADR"

"从PRD.md文件生成ADR，并创建一个todo.md，包含实施任务"

"检查这个代码库的安全问题，并提供屏蔽建议"

服务器返回实际分析结果，而不是提示提交到其他地方！

// 基本项目分析
const analysis = await analyzeProjectEcosystem({
  projectPath: '/path/to/project',
  analysisType: 'comprehensive',
});

// 从需求生成ADR
const adrs = await generateAdrsFromPrd({
  prdPath: 'docs/PRD.md',
  outputDirectory: 'docs/adrs',
});

// 智能代码链接 - 查找与ADR决策相关的代码
const relatedCode = await findRelatedCode(
  'docs/adrs/001-auth-system.md',
  '我们将实现JWT认证与Express中间件',
  '/path/to/project',
  {
    useAI: true, // 基于AI的关键字提取
    useRipgrep: true, // 快速文本搜索
    maxFiles: 10, // 结果限制
    includeContent: true, // 包括文件内容
  }
);

📖 完整使用指南 → | API参考 →

🎯 使用场景

👨‍💻 AI编码助手 - 通过架构智能增强Claude、Cline、Cursor
💬 对话式AI - 以信心评分回答架构问题
🤖 自主代理 - 连续分析和规则执行
🏢 企业团队 - 组合分析和迁移规划

📖 详细使用场景 →

🛠️ 技术栈

运行时: Node.js 20+ • 语言: TypeScript • 框架: MCP SDK • 测试: Jest (>80%覆盖率) 搜索: ripgrep + fast-glob • AI集成: OpenRouter.ai • 网络研究: Firecrawl • 代码分析: 智能代码链接

📖 技术细节 →

📁 项目结构

src/tools/     # 23个MCP工具用于分析
docs/adrs/     # 架构决策记录
tests/         # >80%测试覆盖率
.github/       # CI/CD自动化

📖 完整结构 →

🧪 测试

npm test              # 运行所有测试 (>80%覆盖率)
npm run test:coverage # 覆盖率报告

📖 测试指南 →

🔥 Firecrawl集成（可选）

增强的网络研究能力，用于全面的架构分析。

# 选项1：云服务（推荐）
export FIRECRAWL_ENABLED="true"
export FIRECRAWL_API_KEY="fc-your-api-key-here"

# 选项2：自托管
export FIRECRAWL_ENABLED="true"
export FIRECRAWL_BASE_URL="http://localhost:3000"

# 选项3：禁用（默认 - 服务器无需网络搜索即可工作）

优点: 实时研究 • 增强的ADR • 最佳实践发现 • 智能网络抓取

📖 Firecrawl设置指南 →

🔧 开发

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

质量标准: TypeScript严格模式 • ESLint • >80%测试覆盖率 • 提交前钩子

📖 开发指南 → | 贡献 →

🔧 故障排除

常见问题:

• RHEL系统: 使用特殊安装脚本
• 工具返回提示: 设置EXECUTION_MODE=full + API密钥
• 模块未找到: 运行npm install && npm run build
• 权限被拒绝: 检查文件权限和项目路径

📖 完整故障排除指南 →

🔒 安全与性能

安全: 自动秘密检测 • 内容屏蔽 • 本地处理 • 零信任
性能: 多级缓存 • 增量分析 • 并行处理 • 内存优化

📖 安全指南 → | 性能 →

🔐 安全漏洞报告

发现安全问题？请阅读我们的安全政策，了解负责任披露程序。不要为安全漏洞创建公开问题。

🤝 贡献

我们欢迎贡献！无论是修复错误、添加功能还是改进文档，您的帮助都是宝贵的。

🌟 贡献者快速入门

1. 分叉仓库
2. 克隆您的分叉: git clone https://github.com/YOUR_USERNAME/mcp-adr-analysis-server.git
3. 创建分支: git checkout -b feature/your-feature-name
4. 进行更改并编写测试
5. 测试: npm test（保持>80%覆盖率）
6. 提交拉取请求

👶 第一次贡献？

寻找一个好的开始问题？查看我们的好的第一个问题 - 这些是适合初学者的任务，非常适合开始！

新接触开源？ 我们的贡献指南会一步步引导您完成整个过程。

📝 报告问题

使用我们的问题模板报告错误或请求功能。模板有助于我们更快地理解和解决问题。

标准: TypeScript严格 • >80%覆盖率 • ESLint • 安全验证 • MCP合规

📖 完整贡献指南 → | 行为准则 →

🔗 资源

官方: MCP规范 • MCP SDK
社区: MCP注册表 • Discord
项目: ADR • 进度 • 发布指南

📄 许可证

MIT许可证 - 详情见LICENSE文件。

🙏 致谢

• Anthropic 创建了模型上下文协议
• MCP社区 提供灵感和最佳实践
• 贡献者 使这个项目变得更好

---

由 Tosin Akinosho 创造，用于AI驱动的架构分析

赋予AI助手深度架构智能和决策能力。