MCP Plan Generation

🎯 MCP平面流

使用GitHub副驾驶管理您的实施计划

PlanFlow是一个全面的工具，允许您直接从VS代码创建、验证和审查实施计划。感谢 模型上下文协议（MCP），与GitHub副驾驶聊天以生成结构化计划，然后使用web界面直观地查看它们。

✨ 为什么是Planflow？

• 🤖 Copilot集成 ：通过MCP创建自然语言计划
• 📊 查看视频 ：具有阶段导航的现代web界面
• 💾 坚持 ：MongoDB用于存储和版本控制您的计划
• ⚡ 键盘快捷键 ：使用A（批准）、R（拒绝）、S（跳过）进行快速审查

🚀 快速启动

选项1:Docker（推荐）

# Cloner le projet
git clone 
cd MCP-Plan

# Démarrer l'environnement complet
  docker compose up --build

访问：

• 接口审查 : http://localhost:4173
• API REST : http://localhost:3000
• MongoDB : mongodb://localhost:27017

备选方案2：地方发展

先决条件： Node.js≥18，pnpm≥8，MongoDB本地

# Installation
pnpm install

# Build
pnpm build

# Lancer les deux apps
pnpm dev

API正在运行 http://localhost:3000 et l'interview sur http://localhost:5174.

🔧 使用MCP配置vs代码

要直接在GitHub副驾驶聊天中使用PlanFlow，您需要 双选项 :

选项A:stdio模式（启动专用实例）

文件 .vscode/mcp.json 配置为启动MCP服务器的新实例：

{
  "mcpServers": {
    "planflow": {
      "command": "node",
      "args": ["${workspaceFolder}/packages/mcp-planflow/dist/index.js"],
      "env": {
        "MONGODB_URI": "mongodb://localhost:27017",
        "MONGODB_DB_NAME": "planflow",
        "NODE_ENV": "production",
        "HTTP_ENABLED": "false",
        "MCP_ENABLED": "true"
      }
    }
  }
}

优势 ：简单，无需单独的服务器\ 先决条件 ：项目构建（pnpm --filter mcp-planflow build)

选项B:HTTP模式（连接到当前服务器）

如果您已经通过启动服务器 pnpm dev 或Docker，登录：

{
  "mcpServers": {
    "planflow-http": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

优势 ：重用现有服务器，热重新加载可用，会话管理\ 先决条件 ：服务器启动（pnpm dev 或 docker compose up)\ 运输 ：流式HTTP（现代协议MCP 2025-11-25）

示例文件 ：见 .vscode/mcp-sse.json.example pour la config HTTP完成

💡 使用示例

创建实施计划

提示：

Crée-moi un plan d'implémentation pour ajouter un système d'authentification 
à mon app React avec JWT. Je veux :
- Login/register pages
- Protected routes
- Token refresh automatique
- Logout

MCP将生成一个包含步骤、依赖关系和验证的结构化计划。

验证现有计划

提示：

Valide le plan "auth-system-v2" et dis-moi s'il y a des problèmes 
(dépendances circulaires, IDs dupliqués, etc.)

检索和分析计划

提示：

Récupère le plan "auth-system-v2" et montre-moi les étapes critiques 
sur le chemin de la feature principale

审查联合国计划

提示：

Liste tous les plans en status 'draft' et montre-moi celui 
qui a le plus d'étapes bloquées

然后，您可以打开web界面进行可视化查看：

http://localhost:4173/plans/{planId}/review

创建具有复杂架构的计划

提示：

Génère un plan pour migrer notre backend Express vers NestJS :
- Phase 1 : Setup NestJS à côté de l'existant
- Phase 2 : Migration progressive des routes
- Phase 3 : Migration de la base de données
- Phase 4 : Décommissionnement de l'ancien code

Chaque phase doit avoir des étapes validables et des points de rollback.

✅ GitHub副驾驶的最佳实践

创建前计划的强制性验证

确保您的计划 有效且训练有素，我们建议在文件中添加语句 Agent.md （ou .agent.md 根据您的设置）：

## 📋 Validation des Plans d'Implémentation

Avant de créer un plan d'implémentation, **vous DEVEZ toujours :**

1. **Valider le plan en premier** : Utilisez l'outil `plans-validate` avec le contenu du plan
2. **Attendre la validation** : Assurez-vous que la réponse indique `"isValid": true`
3. **Corriger les erreurs** : Si des erreurs sont rapportées (path: `/steps/X/kind`, etc.), appliquez les corrections
4. **Créer uniquement après succès** : Une fois validé, utilisez `plans-create` avec le plan corrigé

### Exemple de flux correct :

\[计划JSON初始值\] ↓ 计划验证→检测到错误？ ↓ ↓ 否✓是→纠正 ↓ ↓ 计划创建Revalider

### Bénéfices :
- ✅ Évite les allers-retours de correction
- ✅ Plans conformes au schéma PlanFlow v1.1.0
- ✅ Feedback immédiat sur les erreurs de structure
- ✅ Économise token budget et temps

🎯 功能

• MCP 服务器 ：GitHub副驾驶可用的10个工具

- 创建、验证、恢复和更新计划 - 步骤导航（下一步、上一步、上下文） - 计划和步骤的反馈管理

• 界面Web :

- 一步一步地对计划进行可视化审查 - 带相位检测的导航迷你地图 - 关于步骤的评论 - 将评论导出为JSON格式 - Raccourgis-clavier（A：批准，R：拒绝，S：跳过）

• 持久性MongoDB ：您的所有计划都已保存并版本化

MCP工具可用

屏幕画廊

🏠 出生表

Tableau de bord PlanFlow avec plans récents

附录页：

• 统计快速（总计划、待定、进行中、已完成）
• 快速访问以查看所有计划
• 最近计划清单

🔍 计划的详细视图

Vue détaillée avec onglets Overview, Review, Graph, Steps, JSON

L详细界面：

• 概述 ：元数据、目标、范围、约束、成功标准
• 计划信息（ID、标签、版本）
• 导航条目（回顾、图表、步骤）

⭐ 接口审查

Interface complète de review avec minimap et actions

审查要点：

• 小地图 ：导航可视化部分阶段（设置、实施、测试……）
• 活动步骤 ：详细显示shell命令、说明、预计持续时间
• 行动迅速 ：键盘快捷键（A=批准，R=拒绝，S=通过）
• 评论 ：直接在步骤上添加注释

🧩 MCP用户界面（副驾驶聊天）

MCP Review UI in Copilot Chat

捕获GitHub副驾驶聊天（MCP应用程序）中的内置评论界面。

🤖 GitHub副驾驶集成

VS Code avec review côté et Copilot Chat côté droit

工作流程完成：

• 笨拙 ：实时审查界面
• 右边 ：GitHub副驾驶聊天与集成MCP工具
• 底部 ：修改的文件和终端
• 直接通过聊天创建和验证计划

🛠️ 有用的命令

# Arrêter Docker
docker compose down

# Nettoyer la base de données
docker compose down -v

# Rebuild après modifications
docker compose up --build

# Logs en temps réel
docker compose logs -f

📝 许可证

麻省理工学院