AI导哈

架构分析代理

用于分析、同步和改进法国政府补贴模拟器项目架构的模型上下文协议代理。

  • by ShallowRed
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 ShallowRed/aides-simplifiees-mcp

使用说明

简化版MCP代理援助

模型上下文协议代理 用于分析、同步和改进法国政府补贴模拟器项目的架构。

🎯 目的

这个MCP代理有助于在多个工件之间保持一致性和质量：

🛠️ 提供的工具

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日

相关 MCP