Introduction

@dineug/erd-editor-mcp est un serveur MCP qui permet à un agent de codage de modifier des diagrammes erd-editor. Claude Code, Codex et tout autre client du Model Context Protocol disposent d’un outil par opération sur un document : ajouter une table, renommer une colonne, mettre deux tables en relation, importer un dump DDL, relire le schéma en SQL.

Lorsque le document est ouvert dans l’ERD Editor de VS Code, d’Obsidian ou d’un IDE JetBrains, l’agent rejoint l’éditeur comme un collaborateur. Chaque modification apparaît sur le canevas au moment où elle se produit, et l’annulation de l’agent ne défait que ses propres modifications. VS Code garde les modifications de l’agent non enregistrées jusqu’à ce que l’agent ou vous les enregistriez, tandis qu’Obsidian et un IDE JetBrains les enregistrent comme ils enregistrent les vôtres. Lorsqu’aucun éditeur ne détient le document, les mêmes outils modifient le fichier lui-même.

Ce qu’un agent peut faire

• Construire ou modifier un schéma au fil de la conversation : tables, colonnes et toutes les options de colonne, relations avec leur cardinalité et leurs actions ON DELETE et ON UPDATE, index, mémos, couleurs et positions sur le canevas. Voir Relations.
• Rassembler des tables dans des groupes de tables : ajouter un groupe autour des tables que l’agent désigne ou sur une zone du canevas, puis le renommer, le colorer, le déplacer avec ses tables, le redimensionner, y ajouter ou en retirer des tables, ou le supprimer, ce qui laisse ses tables là où elles sont. Voir Groupes de tables.
• Remplacer le document par un schéma analysé à partir de SQL DDL, de GraphQL SDL, de DBML ou d’AML, ou par un autre document .erd.json. Ou bien ajouter ce schéma ou ce document sous le diagramme en conservant tout ce qui s’y trouve déjà, comme le fait Import and Add dans l’éditeur. Dans les deux cas, un TableGroup DBML devient un groupe de tables. Voir Importation.
• Relire le diagramme sous forme de liste d’id, d’entités complètes, du texte .erd.json qu’écrit un enregistrement, ou de DDL pour l’un des huit SGBD, avec les choix Statements et Header de l’onglet Schéma SQL. Sur un schéma de plusieurs milliers de tables, l’agent lit une page, quelques tables ou les tables de quelques groupes de tables à la fois. Voir Lire un document.
• Définir la base de données, le nom de la base de données et les scripts écrits avant et après les tables dans le Schéma SQL, comme CREATE EXTENSION avant elles ou GRANT après elles. erd_read renvoie les scripts seuls, ou au sein du DDL du document entier. Voir Paramètres.
• Exécuter plusieurs modifications comme une seule, en tout ou rien, que défait une seule annulation. Voir erd_batch.
• Annuler et rétablir ses propres modifications, jamais les vôtres.

Ce qu’il ne fait pas :

• Zoomer, faire défiler ou changer d’onglet. Ces actions sont propres à chaque utilisateur, si bien qu’aucun outil ne les effectue. Une importation qui remplace le document déplace tout de même la vue, même avec Viewport verrouillé, comme le fait Import dans l’éditeur : vers le début du canevas à 100 %, ou, avec erd_import_json, vers la vue du document qu’elle charge, et aussi vers son onglet, sauf si ce document verrouille Canvas Type. Voir Importation.
• Modifier View Option, le langage et les casses des noms du générateur de code, le type de délimiteur, ou, dans l’onglet Paramètres, Relationship DataType Sync, Maximum comment width et Column Order. C’est à vous de les définir dans l’éditeur, et l’agent les lit tels que le fichier les enregistre.
• Verrouiller ou déverrouiller un paramètre. Seul erd_import_json, lorsqu’il remplace le document entier, modifie les verrous ou les paramètres ci-dessus, pour leur donner les valeurs du document qu’il charge. Un document sans champ lockSettings, comme un fichier enregistré par l’extension VS Code antérieure à la version 4.0.0 ou par le plugin Obsidian ou JetBrains antérieur à la version 1.0.0, active tous les verrous. L’annulation de toute importation qui a remplacé le document rétablit les paramètres et les verrous qu’avait auparavant le document.
• Réassocier une relation à d’autres colonnes, comme le fait Map Columns. À la place, l’agent supprime la relation, ce qui laisse ses colonnes de clé étrangère en place, et relie les colonnes qu’il veut avec erd_link_columns, dans un seul erd_batch que défait une seule annulation.
• Exécuter le générateur de code. erd_read répond en DDL ou en JSON, et l’agent écrit lui-même le code à partir de ce résultat.

Fonctionnement

Le serveur est un processus stdio que démarre votre client MCP. À chaque appel, il cherche un éditeur qui détient le document : une fenêtre VS Code, une fenêtre de coffre Obsidian ou un IDE JetBrains, chacun avec l’extension ou le plugin ERD Editor.

• En direct. Un éditeur a le document dans son espace de travail, son coffre ou l’un de ses projets ouverts, ou bien l’a ouvert. Le serveur rejoint la session d’édition de cet éditeur et la modification arrive dans l’éditeur : non enregistrée dans VS Code, et enregistrée comme le sont vos propres modifications dans Obsidian et dans un IDE JetBrains.
• Sans interface. Aucun éditeur. Le serveur charge le fichier, applique la modification et réécrit le fichier.
• Refusé. Un éditeur détient le document, mais son hub est désactivé. Le serveur lit depuis le disque mais n’écrit rien, car l’éditeur ouvert pourrait écraser le fichier lors de son prochain enregistrement. Un IDE JetBrains dont le hub est activé refuse aussi de modifier un document détenu uniquement par des projets qu’il n’approuve pas, bien que l’agent puisse toujours le lire. Lorsque le hub de l’éditeur est activé mais que son extension ou son plugin ERD Editor utilise un protocole du hub différent de celui du serveur, tout appel sur le document est refusé, lectures comprises, avec protocolMismatch et un message qui indique le côté à mettre à jour (voir Mettre à jour).

Pour les détails, voir En direct et sans interface.

Prérequis

Node.js	22.12 ou version ultérieure, pour exécuter le serveur
Un client MCP	Claude Code, Codex ou tout client capable de démarrer un serveur stdio
VS Code, pour la modification en direct	1.101.0 ou version ultérieure, avec l’extension ERD Editor 4.0.0 ou version ultérieure
Obsidian, pour la modification en direct	L’application de bureau 1.5.7 ou version ultérieure, avec le plugin ERD Editor 1.0.0 ou version ultérieure
Un IDE JetBrains, pour la modification en direct	Un IDE basé sur IntelliJ 2025.2 ou version ultérieure, avec le plugin ERD Editor 1.0.0 ou version ultérieure

Le serveur 1.0.0 et les versions ci-dessus utilisent le protocole 2 du hub. Les versions antérieures qui prennent en charge les agents utilisent le protocole 1 : l’extension VS Code de la version 3.0.0 à la version 3.1.0, le plugin Obsidian 0.1.0 et 0.2.0, et le plugin JetBrains 0.9.0 et 0.10.0. Une telle version et le serveur 1.0.0 se refusent mutuellement, tout comme un serveur antérieur et les versions ci-dessus (voir Mettre à jour). Une extension VS Code antérieure à la version 3.0.0 ou un plugin JetBrains antérieur à la version 0.9.0 n’a pas de hub : le serveur ne le voit donc pas et modifie le fichier sur le disque, même celui d’un diagramme qui y est ouvert.

Étape suivante : Installation.