MCP Workflow Tracker

Système d'observabilité pour workflows agentiques - Capture l'INTENTION, le RAISONNEMENT et les MODIFICATIONS de code.

🎯 Objectif

Transformer les workflows complexes multi-agents en "boîtes noires" traçables, documentant :

• 🌳 Structure hiérarchique (workflow → tasks → subtasks)

• 🧠 Décisions architecturales avec raisonnement

• ⚠️ Problèmes rencontrés et résolutions

• 📁 Fichiers modifiés (diffs Git automatiques)

• ⏱️ Métriques temporelles et coûts

📚 Documentation

Toute la documentation technique se trouve dans /documentations/ :

Démarrage rapide

1. INDEX.md - Guide de navigation

2. README.md - Vue d'ensemble du projet

3. IMPLEMENTATION-CHECKLIST.md - Guide étape par étape

Références techniques

• DATABASE.md - Schéma Prisma complet

• MCP-SPECS.md - Spécifications des tools MCP

• PROJECT-STRUCTURE.md - Structure du projet

🚀 Quick Start

Setup recommandé (avec Docker)

Documentation Docker complète disponible prochainement dans documentations/DOCKER.md.

Le setup Docker inclura :

• PostgreSQL containerisé (pré-configuré)

• MCP Server prêt à l'emploi

• Pas de configuration manuelle requise

Setup manuel

Note : Le setup manuel supporte PostgreSQL ou SQLite (voir DATABASE.md).

🏗️ Architecture

Monorepo Structure (pnpm workspaces)

📊 Stack Technique

• MCP Server : Node.js + TypeScript + @modelcontextprotocol/sdk

• Database : PostgreSQL (recommandé) ou SQLite (distribution standalone)

• ORM : Prisma (support multi-DB avec enums TypeScript)

• Web UI : Next.js 14 + Socket.io (temps réel)

• Git Integration : simple-git (snapshots/diffs robustes)

• Deployment : Docker Compose (PostgreSQL + services containerisés)

🎯 Phase actuelle : Phase 1 (MCP Server Backend)

Objectif : Implémenter le serveur MCP avec les 6 tools de tracking.

Prochaines étapes :

1. Setup monorepo pnpm

2. Configuration Prisma + PostgreSQL

3. Implémentation des 6 tools MCP

4. Tests avec Claude Code

Durée estimée : 2-3h

Pour commencer l'implémentation → Lire documentations/IMPLEMENTATION-CHECKLIST.md

Pour comprendre l'architecture → Lire documentations/README.md

Pour les specs techniques → Lire documentations/MCP-SPECS.md