mg-kiro-mcp-server

MGX-LJY/mg-kiro-mcp-server

3.2

If you are the rightful owner of mg-kiro-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

MG_kiro is an intelligent dual-mode development assistant that provides structured project management and smart development workflows for Claude Code using the Model Context Protocol (MCP) server.

MG_kiro MCP 服务器

🚀 智能双模式开发助手 — 具备“四层文档管理 + 自动化工作流”的智能开发助手

MG_kiro（Magic Kiro）是一款面向 Claude Code 的 Model Context Protocol（MCP）服务器，为项目提供结构化的项目管理与智能开发工作流。它支持自动模式检测、全栈文档管理，以及智能任务分析。

✨ 关键特性

🔄 智能双模式运行

  • 创建模式（Creation Mode）：面向新项目/新功能的系统化工作流
  • 修复模式（Repair Mode）：基于现有项目知识的智能修复与影响分析
  • 自适应模式（Adaptive Mode）：自动检测并在模式之间切换

📚 四层文档体系

  • 需求层（requirements/）：用户故事、验收标准、业务目标
  • 架构层（architecture/）：系统设计、技术栈、设计原则
  • 连接层（connections/）：模块关系、API 映射、数据流
  • 模块层（modules/）：实现细节、函数定义、测试策略

🤖 AI 驱动能力

  • 自动模式检测：根据用户输入智能切换工作模式
  • 三文档分析：在修复前分析相关文档，评估影响范围
  • 复杂度管理：基于任务复杂度动态调整信息粒度
  • 文档自动同步：代码变更后自动更新相关文档

🚀 快速开始

安装

# 安装依赖
npm install

# 构建项目
npm run build

# 测试启动服务器
npm start

与 Claude Code 集成

# 方式一：使用 npx（推荐）
claude mcp add mg-kiro -s user -- npx -y mg-kiro-mcp-server

# 方式二：全局安装
npm install -g mg-kiro-mcp-server
claude mcp add mg-kiro -s user -- mg-kiro-mcp-server

# 验证安装
claude mcp list

配置

在项目根目录创建 .env 文件：

# 核心配置
MG_KIRO_MODE=adaptive          # 工作模式：adaptive/create/repair
MG_KIRO_COMPLEXITY=auto        # 复杂度：auto/simple/detailed
MG_KIRO_DOC_PATH=.mg_kiro/     # 文档存储路径
MG_KIRO_AUTO_UPDATE=true       # 是否自动更新文档

# 可选高级配置
MG_KIRO_LOG_LEVEL=info         # 日志级别：debug/info/warn/error
MG_KIRO_CACHE_SIZE=100         # 文档缓存大小
MG_KIRO_ANALYSIS_DEPTH=simple  # 分析深度：simple/detailed
MG_KIRO_CONTEXT_WINDOW=100     # 上下文窗口大小
MG_KIRO_CONFIDENCE_THRESHOLD=0.7 # 模式检测置信度阈值

🎮 使用示例

自动模式检测

MG_kiro 会根据你的输入自动选择合适的工作模式：

🧑「我想新增一个支付系统的功能」
🤖「🎯 检测到创建模式 — 正在启动四层文档分析……」

🧑「登录功能有个 bug，Token 过期时间不对」
🤖「🔍 检测到修复模式 — 正在执行三文档分析……」

手动控制模式

# 强制切换到创建模式
mg_switch_mode create

# 强制切换到修复模式
mg_switch_mode repair

# 项目分析
mg_analyze_project

文档管理

# 初始化文档结构
mg_init_docs "My Project" "A web application for task management"

# 分析当前项目状态
mg_analyze_project

# 读取已有文档
在 Claude Code 中使用资源：mg-kiro://docs/requirements/user-stories

📋 工作流示例

创建模式示例

输入：「我想做一个电商购物车功能」

MG_kiro 响应：
🎯 创建模式已激活

📋 需求分析：
- 购物车基础：增删商品、修改数量
- 高级功能：优惠券、运费计算、库存校验

🏗️ 架构设计：
- 前端：React 购物车组件
- 后端：RESTful API + Redis 缓存
- 数据库：商品与购物车表关系设计

🔗 模块连接：
- 前端 ↔ 购物车 API ↔ 商品服务 ↔ 数据库
- 购物车服务 ↔ 优惠券服务
- 购物车服务 ↔ 运费计算器

📝 开发 To-Do：
□ 设计购物车数据模型（15 分钟）
□ 实现购物车 API 接口（30 分钟）
□ 开发前端购物车组件（45 分钟）
□ 集成优惠券功能（30 分钟）
□ 增加运费计算逻辑（20 分钟）

📁 生成的文档：
- .mg_kiro/requirements/shopping-cart.md
- .mg_kiro/architecture/cart-system.md
- .mg_kiro/connections/cart-modules.md
- .mg_kiro/modules/cart-api.md

准备开始第一个任务吗？

修复模式示例

输入：「购物车允许添加超过库存的商品，没有校验」

MG_kiro 响应：
🔍 修复模式分析中……

📐 架构文档检查：
- 现有系统：微服务架构，购物车服务独立部署
- 库存管理：由商品服务负责库存校验

🔗 连接分析：
- 购物车 API → 商品服务（获取库存信息）
- 受影响接口：addToCart()、updateQuantity()
- 数据流：前端请求 → 购物车 API → 商品 API → 库存校验

📦 模块文档审阅：
- 购物车模块当前缺少库存校验逻辑
- 商品模块已提供 getStock() 接口

⚡ 风险等级：低 | 影响范围：2 个模块 | 向后兼容：是

📋 修复计划：
□ 在购物车服务中加入库存校验（10 分钟）
□ 更新 addToCart 与 updateQuantity 接口（15 分钟）
□ 增加库存不足错误处理（10 分钟）
□ 更新前端错误提示（10 分钟）
□ 同步更新相关文档（5 分钟）

📁 待更新文档：
- .mg_kiro/modules/cart-api.md
- .mg_kiro/connections/cart-modules.md

准备执行修复计划吗？

🛠️ 可用工具

模式管理工具

  • mg_detect_mode — 自动检测当前任务的合适工作模式
  • mg_switch_mode — 手动切换工作模式
  • mg_analyze_project — 分析当前项目状态与 MG_kiro 状态

文档管理工具

  • mg_init_docs — 初始化四层文档结构
  • 通过 MCP 资源访问文档：mg-kiro://docs/{type}/{name}

🔧 开发脚本

# 构建与开发
npm run build           # 编译 TypeScript 至 JavaScript
npm run dev             # 监听编译
npm start               # 运行已编译的服务器

# 测试与质量
npm test                # 运行 Jest 测试
npm run lint            # 运行 ESLint
npm run test:integration # 运行集成测试

📖 文档

  • — 完整 API 与工具说明
  • — 详细配置项与环境变量
  • — 常见问题与调试方案

🏗️ 架构总览

核心组件

MG_kiro MCP Server
├── MgKiroServer           # MCP 服务器核心实现
├── ModeController         # 双模式工作流编排
├── DocumentManager        # 四层文档管理
├── ComplexityAnalyzer     # 任务复杂度评估
└── TodoGenerator          # 自动 To-Do 生成

文档结构

.mg_kiro/
├── requirements/
│   ├── user-stories.md
│   ├── acceptance-criteria.md
│   └── business-goals.md
├── architecture/
│   ├── system-design.md
│   ├── tech-stack.md
│   └── design-principles.md
├── connections/
│   ├── api-mappings.md
│   ├── data-flows.md
│   └── integrations.md
└── modules/
    ├── module1.md
    ├── module2.md
    └── implementation-details.md

🤝 与现有工具协同

MG_kiro 旨在与 MCP 生态的其他组件协同工作：

  • GitHub MCP：将文档自动同步到代码仓库
  • Database MCP：查询数据表结构并更新连接文档
  • Search MCP：检索相关技术文档与最佳实践

🧪 测试

# 运行全部测试
npm test

# 仅运行单元测试
npm test -- --testPathPattern="unit"

# 仅运行集成测试
npm run test:integration

# 生成覆盖率报告
npm test -- --coverage

⚡ 性能考量

  • 缓存：文档资源缓存以提升性能
  • 内存管理：大文档采用流式处理而非一次性加载
  • 批处理：尽可能将多文档操作批量化
  • 重试机制：对瞬时性错误采用指数退避自动重试

🔒 安全特性

  • 路径校验：所有文件系统操作均进行校验并在沙箱内执行
  • 访问控制：可配置的文档路径访问限制
  • 输入净化：对所有用户输入进行清洗与校验
  • 安全执行：健壮的错误处理以避免系统暴露

🐛 故障排查

常见问题与简要解决方案：

  1. 服务器无法启动：检查 Node.js 版本（>= 18.0.0）与权限
  2. Claude Code 无法连接：验证 MCP 注册与配置
  3. 文档未生成：检查文档目录权限与初始化状态
  4. 模式检测异常：调整置信度阈值或提供更具体的输入

详见 。

📊 系统要求

  • Node.js：>= 18.0.0
  • 内存：最低 2GB，推荐 4GB
  • 磁盘空间：最低 1GB，推荐 5GB 以获得更佳性能
  • Claude Code：支持 MCP 的最新版本

🚀 开发进度

  • ✅ 阶段 1：MCP 服务器基础框架 — 已完成
  • ✅ 阶段 2：双模式控制器实现 — 已完成
  • ✅ 阶段 3：四层文档系统 — 已完成
  • ✅ 阶段 4：智能复杂度分析 — 已完成
  • ✅ 阶段 5：文档自动同步 — 已完成
  • ✅ 阶段 6：Claude Code 集成测试 — 已完成

📄 许可协议

MIT License — 欢迎自由使用与修改。

🤝 参与贡献

欢迎提交 Issue 与 Pull Request！

开发环境搭建

# 克隆仓库
git clone https://github.com/your-org/mg-kiro-mcp-server.git
cd mg-kiro-mcp-server

# 安装依赖
npm install

# 开发模式运行
npm run dev

# 运行测试
npm test

贡献流程

  1. Fork 仓库
  2. 新建功能分支（git checkout -b feature/amazing-feature）
  3. 实现改动
  4. 为新功能补充测试
  5. 确保全部测试通过（npm test）
  6. 提交变更（git commit -m 'Add amazing feature'）
  7. 推送分支（git push origin feature/amazing-feature）
  8. 创建 Pull Request

🙏 致谢

  • Anthropic：提供 Claude Code 与 MCP 框架
  • Model Context Protocol 社区：提供工具与示例
  • TypeScript 与 Node.js 生态

MG_kiro：让 AI 真正理解你的项目，让开发更有条理 🚀

如需支持、问题反馈或功能请求，请在 GitHub 上 提交 Issue。