Introducción

@dineug/erd-editor-mcp es un servidor MCP que permite a un agente de programación editar diagramas de erd-editor. Claude Code, Codex y cualquier otro cliente del Model Context Protocol disponen de una herramienta por cada operación sobre un documento: añadir una tabla, cambiar el nombre de una columna, relacionar dos tablas, importar un volcado DDL, leer el esquema como SQL.

Cuando el documento está abierto en el ERD Editor de VS Code, Obsidian o un IDE de JetBrains, el agente se une al editor como un colaborador. Cada cambio aparece en el lienzo en el momento en que se produce, y el deshacer del agente revierte solo sus propias ediciones. VS Code mantiene sin guardar los cambios del agente hasta que los guarde el agente o los guardes tú, mientras que Obsidian y un IDE de JetBrains los guardan como guardan los tuyos. Si ningún editor tiene el documento, las mismas herramientas editan el propio archivo.

Qué puede hacer un agente

• Crear o modificar un esquema en una conversación: tablas, columnas y todas las opciones de columna, relaciones con su cardinalidad y sus acciones ON DELETE y ON UPDATE, índices, notas, colores y posiciones en el lienzo. Consulta Relaciones.
• Reunir tablas en grupos de tablas: añadir un grupo alrededor de las tablas que indica o sobre un área del lienzo y, después, cambiarle el nombre, darle color, moverlo con sus tablas, cambiar su tamaño, añadirle o quitarle tablas, o eliminarlo, lo que deja sus tablas donde están. Consulta Grupos de tablas.
• Nombrar tablas y columnas a partir de las palabras y los términos de la pestaña Diccionario del editor, y vincular columnas a sus dominios, que les dan sus tipos de datos. Establece los nombres lógicos de tablas y columnas, y los diccionarios derivan de ellos los nombres físicos como lo hacen en el editor, aunque un nombre físico escrito a mano se mantiene salvo que esté vacío. Añade, cambia y elimina dominios, palabras y términos y, después de que cambie una palabra o un término, vuelve a derivar los nombres físicos de una columna, de una tabla o de todo el documento. Enumera lo que detecta la hoja Checks de la pestaña: palabras prohibidas, palabras no registradas y sinónimos; nombres que comparten dos filas de un mismo diccionario; vínculos con un dominio que el documento no incluye; nombres físicos distintos del que da su término; y columnas que se apartan del tipo de datos de su dominio. Consulta Diccionarios y Comprobaciones del diccionario.
• Reemplazar el documento por un esquema analizado a partir de SQL DDL, GraphQL SDL, DBML o AML, o por otro documento .erd.json. O bien añadir ese esquema o documento debajo del diagrama y conservar todo lo que ya hay, como hace la opción Import and Add del editor. Un TableGroup de DBML se convierte en un grupo de tablas en ambos casos. Un esquema que reemplaza el documento conserva los diccionarios del documento, un documento que lo reemplaza trae los suyos y una adición no trae ninguno. Consulta Importación.
• Leer el diagrama, con sus nombres lógicos y las filas de sus diccionarios, como una lista de ids, como entidades completas o como el texto .erd.json que se escribe al guardar. O bien leerlo como DDL para cualquiera de las ocho bases de datos, con las opciones Statements y Header de la pestaña Esquema SQL y su interruptor Write logical names into empty comments. En un esquema de miles de tablas, lee una página, unas pocas tablas o las tablas de unos pocos grupos de tablas cada vez. Consulta Leer un documento.
• Establecer la base de datos, el nombre de la base de datos y los scripts que se escriben antes y después de las tablas en el Esquema SQL, como un CREATE EXTENSION delante de ellas o un GRANT detrás. erd_read devuelve los scripts solos, o dentro del DDL de todo el documento. Consulta Ajustes.
• Ejecutar varias ediciones como una sola, todas o ninguna, que se revierten con un solo deshacer. Consulta erd_batch.
• Deshacer y rehacer sus propias ediciones, nunca las tuyas.

Lo que no hace:

• Hacer zoom, desplazar la vista o cambiar de pestaña. Eso corresponde a cada persona que ve el diagrama, así que ninguna herramienta lo hace. Aun así, una importación que reemplaza el documento mueve la vista, incluso con Viewport bloqueado, como hace el submenú Import del editor: vuelve al inicio del lienzo al 100 % o, con erd_import_json, a la vista del documento que carga, y también a su pestaña, salvo que ese documento bloquee Canvas Type. Consulta Importación.
• Cambiar la vista de nombres entre Physical Names, Logical Names y Both Names. Corresponde a cada persona que ve el diagrama mientras su bloqueo está activado, como lo está en un diagrama nuevo, y la eliges tú en el editor una vez desactivado el bloqueo, así que ninguna herramienta la cambia. El agente lee y escribe nombres lógicos sea cual sea la vista. Un erd_import_json que reemplaza el documento trae la vista de nombres del documento que carga solo cuando ese documento tiene desactivado el bloqueo Name View.
• Cambiar el menú View Option, el lenguaje y los estilos de nombres del Generador de código, el tipo de delimitador o los ajustes Relationship DataType Sync, Maximum comment width y Column Order de la pestaña Configuración. Esos los ajustas tú en el editor, y el agente los lee tal como los guarda el archivo.
• Activar o desactivar un bloqueo. Solo erd_import_json, al reemplazar todo el documento, cambia los bloqueos o los ajustes indicados arriba, que pasan a ser los del documento que carga. Un documento sin campo lockSettings, como un archivo guardado por la extensión de VS Code anterior a la 4.0.0 o por el plugin de Obsidian o de JetBrains anterior a la 1.0.0, activa todos los bloqueos. Deshacer cualquier importación que haya reemplazado el documento restablece los ajustes y los bloqueos que el documento tenía antes.
• Reasignar una relación a otras columnas, como hace el cuadro de diálogo Map Columns. En su lugar, el agente elimina la relación, lo que deja en su sitio sus columnas de clave externa, y vincula las columnas que quiere con erd_link_columns, en un solo erd_batch que se revierte con un solo deshacer.
• Importar o exportar un diccionario como CSV, ordenar una hoja o insertar filas encima o debajo de una fila, como hace la pestaña Diccionario. El agente añade, cambia y elimina filas, muchas a la vez en un solo erd_batch, y una fila nueva va al final de su hoja.
• Ejecutar el Generador de código. erd_read responde con DDL o JSON, y el propio agente escribe el código a partir de ello.

Cómo funciona

El servidor es un proceso stdio que inicia tu cliente MCP. En cada llamada busca un editor que tenga el documento: una ventana de VS Code, una ventana de bóveda de Obsidian o un IDE de JetBrains, cada uno con la extensión o el plugin ERD Editor.

• En vivo: un editor tiene el documento en su área de trabajo, en su bóveda o en uno de sus proyectos abiertos, o lo tiene abierto. El servidor se une a la sesión de edición de ese editor y la edición llega al editor: sin guardar en VS Code, y guardada igual que tus propias ediciones en Obsidian y en un IDE de JetBrains.
• Headless: no hay ningún editor. El servidor carga el archivo, aplica la edición y vuelve a escribir el archivo.
• Rechazado: un editor tiene el documento, pero con el hub desactivado. El servidor lee desde el disco pero no escribe nada, ya que el editor abierto podría sobrescribir el archivo en su siguiente guardado. Un IDE de JetBrains con el hub activado también se niega a modificar un documento que solo tienen proyectos en los que no confía, aunque el agente aún puede leerlo. Cuando el hub del editor está activado pero su extensión o plugin ERD Editor habla un protocolo de hub distinto del que usa el servidor, se rechaza toda llamada sobre el documento, incluidas las lecturas, con protocolMismatch y un mensaje que indica qué lado hay que actualizar; consulta Actualizar.

Consulta En vivo y headless para ver los detalles.

Requisitos

Node.js	22.12 o posterior, para ejecutar el servidor
Un cliente MCP	Claude Code, Codex o cualquier cliente que pueda iniciar un servidor stdio
VS Code, para la edición en vivo	1.101.0 o posterior, con la extensión ERD Editor 4.0.0 o posterior
Obsidian, para la edición en vivo	La aplicación de escritorio 1.5.7 o posterior, con el plugin ERD Editor 1.0.0 o posterior
Un IDE de JetBrains, para la edición en vivo	Un IDE basado en IntelliJ 2025.2 o posterior, con el plugin ERD Editor 1.0.0 o posterior

El servidor 1.0.0 o posterior y las versiones indicadas arriba usan el protocolo 2 del hub. Las versiones anteriores que dan servicio a agentes usan el protocolo 1: la extensión de VS Code de la 3.0.0 a la 3.1.0, el plugin de Obsidian 0.1.0 y 0.2.0, y el plugin de JetBrains 0.9.0 y 0.10.0. Una versión así y el servidor 1.0.0 o posterior se rechazan mutuamente, y lo mismo ocurre con un servidor anterior y las versiones indicadas arriba; consulta Actualizar. Una extensión de VS Code anterior a la 3.0.0 o un plugin de JetBrains anterior a la 0.9.0 no tiene hub, así que el servidor no lo detecta y edita el archivo en disco, incluso si el diagrama está abierto en él.

Las herramientas para los nombres lógicos, los dominios y los diccionarios necesitan el servidor 1.1.0 o posterior y, allí donde esté abierto el documento, como mínimo la extensión de VS Code 4.2.0 o el plugin de Obsidian o de JetBrains 1.2.0. De las versiones indicadas arriba, una extensión anterior a la 4.2.0 o un plugin anterior a la 1.2.0 sigue permitiendo al agente editar en vivo, ya que usa el protocolo 2, pero ignora los nombres lógicos, los vínculos con dominios y las filas de los diccionarios que escribe el agente, y los omite cuando guarda el archivo. Un servidor anterior a la 1.1.0 que edita un archivo en disco lo vuelve a escribir sin sus nombres lógicos, sus vínculos con dominios ni sus filas de los diccionarios; consulta Actualizar.

Las ediciones que tú y el agente hacéis en el mismo momento sobre el mismo nombre o campo, o sobre la posición o el tamaño de la misma tabla, nota o grupo de tablas, terminan igual en el editor y para el agente con el servidor 1.2.0 o posterior y, allí donde el documento esté abierto, la extensión de VS Code 4.3.0 o posterior o el plugin de Obsidian o JetBrains 1.3.0 o posterior. Un color, la base de datos y el orden de las columnas de una tabla o de un índice son las excepciones; consulta Ediciones hechas en el mismo momento.

Siguiente: Instalación.