Vue d'ensemble
Grace en bref : une plateforme de pilotage des talents pour agents de code.
Grace est une plateforme de pilotage des talents pour agents IA. Un talent est une expertise codifiée (architecture hexagonale, DDD tactique, BDD…) qu'on active par projet. Un serveur MCP ne sert alors au LLM que les talents configurés, et un dashboard web permet de composer cette sélection.
Même cœur (le resolver), deux front-ends : la génération de fichiers (grace build)
et le serveur MCP distant.
Périmètre
Ce dépôt est le POC de la plateforme Grace (web + MCP distant), distinct du CLI
HoppR-tech/grace et de la registry
HoppR-tech/hoppr-talents.
Le principe en une image
flowchart LR
repo["Repo client<br/>.mcp.json (token projet)"] -->|MCP HTTP + Bearer| mcp
subgraph vps["VPS · docker-compose"]
mcp["mcp<br/>(adaptateur MCP)"] -->|HTTP interne| backend
frontend["frontend<br/>(React)"] -->|/api| backend
backend["backend<br/>(NestJS) — resolver, validate, auth, catalogue"] --> pg[("postgres")]
end
nav["Navigateur"] --> frontendLe mcp et le frontend lisent et écrivent la même base via le backend : la
sélection de talents est pilotable depuis le dashboard et depuis le LLM, en temps réel.
Structure du dépôt
| Dossier | Rôle |
|---|---|
platform/ | La plateforme : backend/ (NestJS), frontend/ (React + Vite), mcp/ (adaptateur MCP HTTP), docs/ (ce site), docker-compose.yml, Caddyfile |
catalog/ | Catalogue de talents (17) + persona + schéma d'un talent (TALENT-STRUCTURE.md) + _TEMPLATE/ |
docs/ | Documentation repo-locale : carte du code (CODEBASE.md), architecture, moteur, MCP, dashboard, contexte & ADR |
Stack
NestJS · React + Tailwind v4 · @modelcontextprotocol/sdk (Streamable HTTP) ·
PostgreSQL + Drizzle · Better Auth (e-mail/mdp, Google, SSO OIDC/SAML par org) · Caddy ·
Docker Compose. Multitenant par organisation : l'accès au serveur MCP est conditionné à
l'approbation de l'organisation par un admin plateforme.
Par où commencer
- Nouveau ? Lis Concepts & vocabulaire, puis Démarrage rapide.
- Tu branches un projet ? Vois Brancher un projet.
- Tu écris un talent ? Vois Écrire un talent.