# uml-mcp : D’un appel MCP à un diagramme

> uml-mcp est un serveur MCP qui transforme la source de diagramme d’une conversation en SVG ou PNG grâce à Kroki et quatre extensions, avec une visionneuse dans la conversation, un cache de rendu et des solutions de repli. Vidéo de démonstration, chaîne de traitement et limites tirées du code.

- Page HTML: https://antoineboucher.info/CV/blog/fr/projects/notes/uml-mcp/
- Langue: fr
- Traduction (en): https://antoineboucher.info/CV/blog/projects/notes/uml-mcp/index.md
- Publié: 2026-10-23
- Mis à jour: 2026-11-06
- Auteur: Antoine Boucher (https://antoineboucher.info/CV/index-en.html)

- Dépôt: https://github.com/antoinebou12/uml-mcp
- Licence: MIT
- Révision inspectée: ebaeac6eb6737639cd1fd5e92967408309a9a64d

## Résumé

uml-mcp expose des outils de diagrammes aux clients MCP. Le client fournit une source et des options; le serveur valide la demande, l’oriente vers les services de rendu et retourne les résultats avec des liens d’édition.

**Pourquoi il existe:** Serveur phare Model Context Protocol (MCP) générant PlantUML, Mermaid et Kroki directement depuis des LLMs (Claude, Cursor, ChatGPT) sans dépendance locale.

**Cas d’usage:** Génération interactive de diagrammes d'architecture pour le pair programming avec IA et la documentation.

## Cas d’utilisation

Serveur MCP qui permet aux assistants IA de transformer une source ou une description en diagramme rendu dans la conversation.

- **Rendre un diagramme** (Client MCP (chat IA), Kroki / PlantUML): generate_uml reçoit un diagram_type, le code source, un format et un thème optionnel, fait le rendu via Kroki (KROKI_SERVER, https://kroki.io par défaut) et renvoie le fichier, son URL et un lien vers le terrain de jeu.
- **Valider une source** (Client MCP (chat IA)): validate_uml vérifie le type, le format et la structure de base en local, sans rendu, pour que l'assistant corrige la source avant de lancer le rendu.
- **Rendre un lot de diagrammes** (Client MCP (chat IA), Kroki / PlantUML): generate_uml_batch rend plusieurs éléments en parallèle limité, dans l'ordre reçu, jusqu'à la limite batch_max_items.
- **Retoucher dans le visualiseur** (Développeur, Client MCP (chat IA)): Dans les clients compatibles MCP Apps, le résultat s'ouvre dans ui://uml-mcp/diagram-viewer : zoom, édition de la source, changement de thème ou de format, export SVG, PNG, HTML ou PDF.
- **Héberger le serveur soi-même** (Développeur, Kroki / PlantUML): uv tool install uml-mcp && uml-mcp setup l'installe en local ; docker-compose.yml lance le serveur sur le port 8000 avec des conteneurs Kroki et un profil PlantUML de secours optionnel, et deploy/helm/uml-mcp vise Kubernetes.

### Scénario : Dessiner une séquence de connexion depuis Cursor

1. Ajouter le point d'accès hébergé https://uml-mcp.vercel.app/mcp à la configuration MCP, comme dans .cursor/mcp.json.
2. Demander à l'assistant : « Dessine un diagramme de séquence d'un utilisateur qui se connecte via une passerelle d'API. »
3. L'assistant appelle list_diagram_types, écrit la source Mermaid ou PlantUML et la vérifie avec validate_uml.
4. Il appelle generate_uml_image ; le serveur fait le rendu via Kroki et renvoie un PNG en ligne avec les liens de rendu et de terrain de jeu.
5. Ouvrir le lien du terrain de jeu ou le visualiseur MCP App pour retoucher la source et exporter en SVG.

## Langages (octets GitHub Linguist)

| Langage | % |
| --- | ---: |
| Python | 90.9 |
| TypeScript | 7.99 |
| Shell | 0.31 |
| CSS | 0.26 |
| Go Template | 0.23 |
| Makefile | 0.14 |
| Dockerfile | 0.11 |
| JavaScript | 0.03 |
| HTML | 0.02 |

## Démarrage (commandes du dépôt, non exécutées ici)

### README.md · Quick start

```bash
git clone https://github.com/antoinebou12/uml-mcp.git
cd uml-mcp
uv sync
uv run python server.py
```

### README.md · Quick start

```bash
git remote add origin https://github.com/antoinebou12/uml-mcp.git
```

### tests/mcp-rig/README.md · Running

```bash
make mcp-rig
```

### tests/mcp-rig/README.md · Running

```bash
uvx mcp-rig@0.1.0 run tests/mcp-rig/
uvx mcp-rig@0.1.0 run tests/mcp-rig/ --tag smoke
uvx mcp-rig@0.1.0 run tests/mcp-rig/generate.yaml --case "batch*"
uvx mcp-rig@0.1.0 run tests/mcp-rig/ --server-logs   # show server stderr when debugging
```


## Fonctions et composants

- **Un point d’entrée sans sortie parasite** — server.py délègue le démarrage à mcp_core.core.server. L’objet mcp est résolu à la demande par __getattr__, ce qui évite de construire le serveur ou d’écrire sur stdout lors d’un simple import. C’est important quand stdout transporte le protocole stdio.
- **Transport et rendu** — Le serveur propose des parcours stdio et HTTP. Le cœur regroupe l’enregistrement des outils, la configuration et l’intégration Kroki. Le rendu reste une opération en aval: la couche MCP décrit les outils et transporte leurs entrées et résultats.

## Architecture

Composants et connexions vérifiés dans le dépôt.

- Client MCP → Transport stdio ou HTTP
- Transport stdio ou HTTP → Outils FastMCP et validation
- Outils FastMCP et validation → Moteur Kroki
- Moteur Kroki → Résultat et liens
- Résultat et liens → Client MCP

```mermaid
flowchart LR
  n0["Client MCP"]
  n1["Transport stdio ou HTTP"]
  n2["Outils FastMCP et validation"]
  n3["Moteur Kroki"]
  n4["Résultat et liens"]
  n0 --> n1
  n1 --> n2
  n2 --> n3
  n3 --> n4
  n4 --> n0
```

**Un parcours dans le code:** Partez de server.py, suivez main dans mcp_core, puis examinez l’outil de diagramme avant son moteur. Un appel fournit des arguments structurés, sans rendre automatiquement un texte quelconque valide en Mermaid ou PlantUML.

## API



## Limites et points à vérifier

Le rendu distant transmet la source du diagramme. Vérifiez le service utilisé et sa politique de données avant d’envoyer une architecture interne ou d’autres informations confidentielles.

## Fichiers à lire

- [server.py](https://github.com/antoinebou12/uml-mcp/blob/main/server.py)
- [mcp_core/core/server.py](https://github.com/antoinebou12/uml-mcp/blob/main/mcp_core/core/server.py)
- [README.md](https://github.com/antoinebou12/uml-mcp/blob/main/README.md)