Sarrera

@dineug/erd-editor-mcp MCP zerbitzari bat da, eta kodetze-agente bati erd-editor diagramak editatzen uzten dio. Claude Code, Codex eta Model Context Protocol protokoloaren beste edozein bezerok tresna bat jasotzen dute dokumentu baten gaineko eragiketa bakoitzeko: taula bat gehitzea, zutabe bati izena aldatzea, bi taula erlazionatzea, DDL iraulketa bat inportatzea, eskema SQL gisa berriro irakurtzea.

Dokumentua VS Code, Obsidian edo JetBrains IDE bat barruko ERD Editor editorean irekita dagoenean, agentea editorera batzen da, lankide bat bezala. Aldaketa bakoitza gertatu ahala agertzen da oihalean, eta agenteak, desegitean, bere edizioak soilik leheneratzen ditu. VS Code editoreak agentearen aldaketak gorde gabe uzten ditu agenteak edo zuk gorde arte; Obsidian aplikazioak eta JetBrains IDE batek, berriz, zure aldaketak gordetzen dituzten bezala gordetzen dituzte. Dokumentua daukan editorerik ez badago, tresna berek fitxategia bera editatzen dute.

Agente batek zer egin dezakeen

• Eskema bat sortzea edo aldatzea elkarrizketan: taulak, zutabeak eta zutabe-aukera guztiak, erlazioak beren kardinalitatearekin eta beren ON DELETE eta ON UPDATE ekintzekin, indizeak, oharrak, koloreak eta oihaleko kokapenak. Ikus Erlazioak.
• Taulak taula-taldeetan biltzea: talde bat gehitzea izendatzen dituen taulen inguruan edo oihaleko eremu baten gainean, eta ondoren taldeari izena aldatzea, koloreztatzea, bere taulekin mugitzea, tamainaz aldatzea, taulak sartzea edo ateratzea, edo kentzea; taldea kentzeak haren taulak dauden lekuan uzten ditu. Ikus Taula-taldeak.
• Taulei eta zutabeei izena ematea editorearen Hiztegia fitxako hitzetatik eta terminoetatik abiatuta, eta zutabeak haren domeinuei lotzea, horiek ematen baitizkiete datu motak. Taulen eta zutabeen izen logikoak ezartzen ditu, eta hiztegiek haietatik eratortzen dituzte izen fisikoak, editorean bezala, nahiz eta eskuz idatzitako izen fisiko bat bere horretan geratzen den, hutsik ez badago. Domeinuak, hitzak eta terminoak gehitzen, aldatzen eta kentzen ditu, eta hitz edo termino bat aldatu ondoren, izen fisikoak berriro eratortzen ditu zutabe baterako, taula baterako edo dokumentu osorako. Fitxako Checks orriak aurkitzen duena zerrendatzen du: hitz debekatuak, erregistratu gabeko hitzak eta sinonimoak; hiztegi bereko bi errenkadak partekatzen dituzten izenak; dokumentuak zerrendatzen ez duen domeinu baterako loturak; beren terminoak ematen duenaz bestelako izen fisikoak; eta beren domeinuaren datu motatik aldendutako zutabeak. Ikus Hiztegiak eta Hiztegiaren egiaztapenak.
• Dokumentua ordeztea SQL DDL, GraphQL SDL, DBML edo AML formatutik analizatutako eskema batekin, edo beste .erd.json dokumentu batekin. Edo eskema edo dokumentu hori diagramaren azpian gehitzea eta lehendik dagoen guztia mantentzea, editorearen Import and Add aukerak egiten duen bezala. DBML TableGroup bat taula-talde gisa iristen da bi kasuetan. Dokumentua ordezten duen eskema batek dokumentuaren hiztegiak mantentzen ditu, hura ordezten duen dokumentu batek bereak dakartza, eta gehikuntza batek ez du bat ere ekartzen. Ikus Inportazioa.
• Diagrama berriro irakurtzea, bere izen logikoekin eta hiztegietako errenkadekin, ID zerrenda gisa, entitate oso gisa edo gordetzeak idazten duen .erd.json testu gisa. Edo zortzi datu-baseetako edozeinen DDL gisa irakurtzea, SQL eskema fitxako Statements eta Header aukerekin eta haren Write logical names into empty comments etengailuarekin. Milaka taulako eskema batean, orrialde bat, taula gutxi batzuk edo taula-talde gutxi batzuen taulak irakurtzen ditu aldi bakoitzean. Ikus Dokumentu bat irakurtzea.
• Datu-basea, datu-basearen izena eta SQL eskeman taulen aurretik eta ondoren idazten diren scriptak ezartzea, hala nola taulen aurretik CREATE EXTENSION sententzia edo ondoren GRANT sententzia. erd_read tresnak scriptak bakarrik ematen ditu, edo dokumentu osoaren DDLaren barruan. Ikus Ezarpenak.
• Hainbat edizio edizio bakar gisa exekutatzea, denak ala bat ere ez; desegite bakar batek leheneratzen ditu. Ikus erd_batch.
• Bere edizioak desegitea eta berregitea, inoiz ez zureak.

Zer ez duen egiten:

• Zooma aldatzea, korritzea edo fitxaz aldatzea. Horiek ikusle bakoitzari dagozkio; beraz, ez dago hori egiten duen tresnarik. Hala ere, dokumentua ordezten duen inportazio batek ikuspegia mugitzen du, baita Viewport blokeoa aktibatuta egonda ere, editorearen Import aukerak egiten duen bezala: oihalaren hasierara, % 100ean, edo, erd_import_json tresnarekin, kargatzen duen dokumentuaren ikuspegira, eta haren fitxara ere, dokumentu horrek Canvas Type blokeatuta ez badu. Ikus Inportazioa.
• Izenen ikuspegia Physical Names, Logical Names eta Both Names ikuspegien artean aldatzea. Ikusle bakoitzari dagokio haren blokeoa aktibatuta dagoen bitartean, diagrama berri batean dagoen bezala, eta zuk aukeratzen duzu editorean blokeoa desaktibatuta dagoenean; beraz, ez dago hori egiten duen tresnarik. Agenteak izen logikoak irakurri eta idazten ditu, ikuspegia edozein dela ere. Dokumentua ordezten duen erd_import_json tresnak kargatzen duen dokumentuaren Izenen ikuspegia dakar soilik dokumentu horrek Name View blokeoa desaktibatuta duenean.
• View Option aukerak, Kode-sortzailearen lengoaia eta izenen idazkerak, mugatzaile mota, edo Ezarpenak fitxako Relationship DataType Sync, Maximum comment width eta Column Order aukerak aldatzea. Horiek zuk ezartzen dituzu editorean, eta agenteak fitxategian gordeta dauden bezala irakurtzen ditu.
• Blokeo bat aktibatzea edo desaktibatzea. Dokumentu osoa ordezten duen erd_import_json tresnak soilik aldatzen ditu blokeoak edo goiko ezarpenak, kargatzen duen dokumentuarenetara. lockSettings eremurik ez duen dokumentu batek, hala nola 4.0.0 bertsioa baino lehenagoko VS Code luzapenak edo 1.0.0 bertsioa baino lehenagoko Obsidian edo JetBrains pluginak gordetako fitxategi batek, blokeo guztiak aktibatzen ditu. Dokumentua ordeztu duen edozein inportazio desegiteak dokumentuak lehen zituen ezarpenak eta blokeoak itzultzen ditu.
• Erlazio bat beste zutabe batzuetara berriro mapatzea, Map Columns aukerak egiten duen bezala. Horren ordez, agenteak erlazioa kentzen du, eta haren gako arrotzeko zutabeak beren lekuan geratzen dira; ondoren, nahi dituen zutabeak lotzen ditu erd_link_columns tresnarekin, desegite bakar batek leheneratzen duen erd_batch dei bakarrean.
• Hiztegi bat CSV gisa inportatzea edo esportatzea, orri bat ordenatzea, edo errenkada baten gainean edo azpian errenkadak txertatzea, Hiztegia fitxak egiten duen bezala. Agenteak errenkadak gehitzen, aldatzen eta kentzen ditu, asko aldi berean erd_batch dei bakarrean, eta errenkada berri bat bere orriaren amaieran jartzen da.
• Kode-sortzailea exekutatzea. erd_read tresnak DDLa edo JSONa ematen du erantzun gisa, eta agenteak berak idazten du kodea hortik abiatuta.

Nola funtzionatzen duen

Zerbitzaria zure MCP bezeroak abiarazten duen stdio prozesu bat da. Dei bakoitzean, dokumentua daukan editore bat bilatzen du: VS Code leiho bat, Obsidian biltegi-leiho bat edo JetBrains IDE bat, bakoitza ERD Editor luzapenarekin edo pluginarekin.

• Zuzenean — editore batek dokumentua bere lan-eremuan, bere biltegian edo bere proiektu irekietako batean dauka, edo irekita dauka. Zerbitzaria editore horren edizio-saioan sartzen da, eta edizioa editorean gauzatzen da: VS Code editorean, gorde gabe, eta Obsidian aplikazioan eta JetBrains IDE batean, zure edizioak gordetzen diren bezala gordeta.
• Editorerik gabe — ez dago editorerik. Zerbitzariak fitxategia kargatzen du, edizioa aplikatzen du eta fitxategia berriro idazten du.
• Ukatua — editore batek dauka dokumentua, baina agente-gunea desaktibatuta du. Zerbitzariak diskotik irakurtzen du, baina ez du ezer idazten, irekita dagoen editoreak fitxategia gainidatz baitezake hurrengo gordetzean. Gunea aktibatuta duen JetBrains IDE batek ere ukatu egiten du fidagarritzat ez dituen proiektuek soilik daukaten dokumentu bat aldatzea, baina agenteak irakur dezake oraindik. Editorearen gunea aktibatuta dagoenean, baina haren ERD Editor luzapenak edo pluginak zerbitzariarenaz bestelako gune-protokolo bat erabiltzen duenean, dokumentuaren gaineko dei oro ukatzen da, irakurketak barne, protocolMismatch kodearekin eta eguneratu beharreko aldea izendatzen duen mezu batekin. Ikus Eguneratzea.

Xehetasunetarako, ikus Zuzenean eta editorerik gabe.

Eskakizunak

Node.js	22.12 edo berriagoa, zerbitzaria exekutatzeko
MCP bezero bat	Claude Code, Codex edo stdio zerbitzari bat abiaraz dezakeen edozein bezero
VS Code, zuzeneko ediziorako	1.101.0 edo berriagoa, ERD Editor luzapenaren 4.0.0 bertsioarekin edo berriagoarekin
Obsidian, zuzeneko ediziorako	Mahaigaineko aplikazioaren 1.5.7 bertsioa edo berriagoa, ERD Editor pluginaren 1.0.0 bertsioarekin edo berriagoarekin
JetBrains IDE bat, zuzeneko ediziorako	IntelliJ plataforman oinarritutako IDE baten 2025.2 bertsioa edo berriagoa, ERD Editor pluginaren 1.0.0 bertsioarekin edo berriagoarekin

1.0.0 edo berriagoa den zerbitzariak eta goiko taulako bertsioek gune-protokoloaren 2. bertsioa erabiltzen dute. Agenteei zerbitzua ematen dieten aurreko bertsioek protokoloaren 1. bertsioa erabiltzen dute: VS Code luzapenaren 3.0.0 bertsiotik 3.1.0 bertsiora artekoek, Obsidian pluginaren 0.1.0 eta 0.2.0 bertsioek, eta JetBrains pluginaren 0.9.0 eta 0.10.0 bertsioek. Horrelako bertsio batek eta 1.0.0 edo berriagoa den zerbitzariak elkar ukatzen dute, baita aurreko zerbitzari batek eta goiko taulako bertsioek ere. Ikus Eguneratzea. 3.0.0 bertsioa baino lehenagoko VS Code luzapen batek edo 0.9.0 bertsioa baino lehenagoko JetBrains plugin batek ez du agente-gunerik; beraz, zerbitzariak ez du ikusten, eta diskoko fitxategia editatzen du, baita bertan irekita dagoen diagrama bat ere.

Izen logikoetarako, domeinuetarako eta hiztegietarako tresnek 1.1.0 edo berriagoa den zerbitzaria behar dute eta, dokumentua irekita dagoen lekuan, gutxienez VS Code luzapenaren 4.2.0 bertsioa edo Obsidian edo JetBrains pluginaren 1.2.0 bertsioa. Goiko bertsioen artean, 4.2.0 bertsioa baino lehenagoko luzapen batek edo 1.2.0 bertsioa baino lehenagoko plugin batek agenteari zuzenean editatzen uzten dio oraindik, protokoloaren 2. bertsioa erabiltzen baitu, baina ez die jaramonik egiten agenteak idazten dituen izen logikoei, domeinu-loturei eta hiztegietako errenkadei, eta kanpoan uzten ditu fitxategia gordetzean. 1.1.0 bertsioa baino lehenagoko zerbitzari batek, fitxategi bat diskoan editatzen duenean, haren izen logikoak, domeinu-loturak eta hiztegietako errenkadak gabe idazten du berriro. Ikus Eguneratzea.

Zuk eta agenteak une berean izen edo eremu berari, edo taula, ohar edo taula-talde beraren kokapenari edo tamainari egindako edizioak berdin amaitzen dira editorean eta agentearentzat, 1.2.0 edo berriagoa den zerbitzariarekin eta, dokumentua irekita dagoen tokian, VS Code luzapenaren 4.3.0 edo berriagoarekin edo Obsidian edo JetBrains pluginaren 1.3.0 edo berriagoarekin. Kolorea, datu-basea eta taula edo indize bateko zutabeen ordena salbuespenak dira. Ikus Une berean egindako edizioak.

Hurrengoa: Instalazioa.