简化版MCP代理援助
模型上下文协议代理 用于分析、同步和改进法国政府补贴模拟器项目的架构。
🎯 目的
这个MCP代理有助于在多个工件之间保持一致性和质量：
- Figma设计UI/UX模型和用户流程
- 领域模型术语表和业务规则
🛠️ 提供的工具
1. 域名术语检查器 ✅
验证JSON/YAML文件中的字段命名规范、枚举标准化以及数据一致性。
2. GitHub 仓库分析器 🚧（施工中/禁止通行）
克隆并分析实际代码库以提取：
- 组件结构和依赖关系
- API路由和端点
- 进出口图表
- 模拟器实现
3. 架构分析器 🚧（施工中/维修中）
检测代码质量问题：
- 组件耦合度指标
- 代码重复
- 循环依赖
- 复杂性度量指标（圈复杂度、认知复杂度）
4. 文档代码同步验证器 🚧（施工中/道路封闭/请绕行等，具体含义根据上下文而定）
确保文档与实施相匹配：
- API端点漂移检测
- 过时的代码示例
- 缺少文件
5. Figma 集成 🚧（施工中/道路封闭等）
使设计与代码同步：
- 屏幕到路由的映射
- 组件名称一致性
- 字段ID验证
6. 架构推荐引擎 🚧（施工中/禁止通行等警示标志）
提供可操作的建议：
- 重构机会
- 共享组件提取
- 关注点分离的改进
- 可重用性增强
7. 统一报告 🚧（施工中/道路封闭等警示标志，具体含义根据上下文而定）
生成全面的健康报告：
- 跨工件同步状态
- 架构质量评分
- 优先改进清单
🚀 快速入门
安装
pnpm install
pnpm run build作为MCP服务器的使用
在您的MCP客户端配置中添加（例如，Claude桌面）：
{
"mcpServers": {
"aides-simplifiees": {
"command": "node",
"args": ["/path/to/aides-simplifiees-mcp/dist/index.js"],
"env": {
"FIGMA_TOKEN": "your-figma-token-here"
}
}
}
}作为命令行界面（CLI）使用
# Lint domain terms
pnpm run lint:domain
# Analyze architecture
pnpm run dev:cli analyze-architecture
# Check sync status
pnpm run dev:cli check-sync📁 项目结构
aides-simplifiees-mcp/
├── src/
│ ├── index.ts # MCP server entry point
│ ├── cli.ts # CLI entry point
│ ├── types/ # Shared TypeScript types
│ ├── tools/ # MCP tool implementations
│ │ ├── domainTermLinter.ts
│ │ ├── githubAnalyzer.ts
│ │ ├── architectureAnalyzer.ts
│ │ ├── docSyncValidator.ts
│ │ ├── figmaSync.ts
│ │ ├── recommendationEngine.ts
│ │ └── unifiedReporting.ts
│ └── utils/ # Shared utilities
├── domain/
│ └── glossaire.yml # Domain glossary
├── domain-rules.json # Linting rules
└── README.md🧪 测试
npm test📚 文档
查看 instructions.txt 翻译为中文是：“说明文件.txt” 或 “指令文件.txt” 对于完整的实施计划和架构指南。
🤝 贡献
该项目遵循简化援助协议的惯例：
- 字段IDsnake_case，不使用连字符，不使用重音符号
- 枚举（Enums）来自术语表的规范化短语
- 金钱价值12个月的合计数（或总计）与
_12m_eur后缀 - 地理更倾向于使用INSEE代码而非邮政编码
📄 许可证
这个项目是法国政府beta.gouv.fr倡议的一部分。
______________________________________________________________________
状态🚧 活跃开发中 | 版本0.1.0 | 最后更新时间2025年10月22日