ERD Editor MCP
MCP-сервер для редактора ERD-диаграмм: агент добавляет таблицы, связи и индексы, а правки сразу видны на холсте в VS Code, Obsidian и JetBrains
- 1 736 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запускает локальный процесс через npx и читает и пишет файлы диаграмм `.erd.json` в рабочей папке
- Подключается к запущенным редакторам через каталог `~/.erd-editor/ide/` и меняет открытые документы
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/erd-editorОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает локальный процесс через npx и читает и пишет файлы диаграмм `.erd.json` в рабочей папке
- Подключается к запущенным редакторам через каталог `~/.erd-editor/ide/` и меняет открытые документы
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ERD Editor рисует схему базы данных в виде ER-диаграммы в браузере, VS Code, IDE от JetBrains или Obsidian. Внутри репозитория лежит пакет `@dineug/erd-editor-mcp`: он дает Claude Code, Codex и другим MCP-клиентам набор инструментов `erd_*` для правки такой диаграммы. Агент добавляет таблицу, переименовывает столбец, связывает две таблицы, задает индекс, ставит первичный ключ или заметку на холсте. Если нужный документ уже открыт в редакторе, агент подключается к нему как еще один участник, и правка появляется на холсте сразу. Его отмена откатывает только его собственные изменения. Когда редактора нет, те же инструменты пишут прямо в файл `.erd.json`. Схему можно загрузить из SQL, DBML, GraphQL, AML или JSON инструментами `erd_import_*`, а прочитать обратно как снимок, JSON или SQL для любой из восьми баз данных. Для больших схем есть постраничный `erd_list` по сто таблиц и выдача DDL только по названным таблицам. Инструмент `erd_batch` выполняет до ста правок подряд как одну: либо все, либо ни одной.
Для кого. Для разработчиков и аналитиков, которые проектируют схему базы данных вместе с ИИ-агентом и хотят видеть ER-диаграмму, а не только SQL-файлы.
Подходит, если
- Нужно набросать схему базы данных по описанию задачи и сразу посмотреть ее диаграммой в VS Code
- Есть готовый SQL-дамп, и его надо превратить в ER-диаграмму через `erd_import_sql`
- Схему из DBML или GraphQL надо импортировать и вывести как DDL для PostgreSQL, MySQL или другой из восьми баз
- Агент должен массово поправить схему: переименовать столбцы, добавить индексы и связи одним вызовом `erd_batch`
- Диаграмма хранится в репозитории файлом `.erd.json`, и агент правит ее без запущенного редактора
Не подходит, если
- Нужен доступ к живой базе данных, запросы и миграции: сервер редактирует только файл диаграммы
- Вам нужны произвольные блок-схемы и архитектурные рисунки: для этого есть Mermaid и draw.io
- На машине нет Node.js 22.12 или новее
- Диаграмма открыта в JetBrains IDE, установленной как Flatpak: там агент правит файл на диске и перезаписывается вашей следующей правкой
Пример запроса к агенту
Создай в docs/shop.erd.json схему интернет-магазина: клиенты, заказы, товары и позиции заказа со связями, затем покажи DDL для PostgreSQLMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
- Нужен Node.js 22.12 или новее, `npx` скачивает сервер при первом запуске.
- Редактор и сервер надо обновлять вместе: при разных версиях протокола сервер отказывается подключаться и называет сторону, которую надо обновить.
- Если редактор открыт, но подключение агентов в нем выключено или рабочая папка не доверенная, правка отклоняется, чтобы следующее сохранение редактора не затерло ее. Чтение при этом идет с диска.
- В VS Code живая правка остается несохраненной, пока вы, автосохранение или `erd_save` не сохраните файл.
- Одно чтение отдает не больше 40 000 знаков, для большой схемы читайте по таблицам.
- В Obsidian из Flathub и JetBrains IDE во Flatpak центра подключений нет, агент правит файл на диске.
Как отключить. Удалите сервер из конфигурации клиента: для Claude Code выполните `claude mcp remove erd-editor`, для Codex уберите блок `[mcp_servers.erd-editor]` из `config.toml`. Подключение агентов в самом редакторе выключает настройка `Coding agents` в Obsidian и JetBrains или `dineug.erd-editor.agentHub.enabled` в VS Code.
Частые вопросы
Как поставить ERD Editor в Claude Code?
В папке проекта выполните `claude mcp add --transport stdio erd-editor -- npx -y @dineug/erd-editor-mcp`. Сервер запустится через `npx` при первом обращении агента, нужен Node.js 22.12 или новее.
Как подключить ERD Editor к Codex?
Выполните `codex mcp add erd-editor -- npx -y @dineug/erd-editor-mcp`. Настройка общая для CLI, приложения и расширения IDE. Можно вместо команды вписать в `~/.codex/config.toml` блок `[mcp_servers.erd-editor]` с `command = "npx"`.
Нужен ли открытый редактор, чтобы агент менял схему?
Нет. Если документ открыт в VS Code, Obsidian или JetBrains IDE, правка появляется на холсте сразу. Без редактора сервер пишет в файл диаграммы. Если редактор держит документ, но подключение агентов у него выключено, сервер отказывает.
Из каких форматов можно импортировать схему?
Инструменты `erd_import_sql`, `erd_import_graphql`, `erd_import_dbml`, `erd_import_aml` и `erd_import_json` загружают схему. По умолчанию импорт заменяет диаграмму, а с параметром `mode: "append"` дописывает таблицы к ней.
Как вывести схему в SQL для нужной базы данных?
Инструмент `erd_read` отдает документ как `sql` для любой из восьми баз данных. Для большой схемы можно запросить DDL только нужных таблиц или групп таблиц, ответ ограничен 40 000 знаками.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыДесктопное рабочее место для SQL с встроенным MCP-сервером: агент читает схему и выполняет запросы в том же клиенте, где работаете вы
Легкое рабочее место для баз данных с MCP-сервером: агент читает схему, выполняет запросы и разбирает данные в PostgreSQL, MySQL и других
MCP-сервер и CLI для управления настоящим Microsoft Excel: Power Query, DAX, VBA, сводные таблицы, диаграммы
CLI и MCP-сервер для извлечения структурированных знаний из документов: графы, гиперграфы и поиск по фактам с источниками
MCP-сервер и CLI для генерации научных схем, диаграмм и графиков из текста статьи или данных
MCP-сервер подключает Claude Code и Codex к открытой сессии R или Python в RStudio и Positron, где лежат ваши данные
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| ERD Editor (эта запись) | да | не нужна | 1 736 | |
| MCP Mermaid | нет | не нужна | 646 | рисует диаграммы Mermaid из текста, схему базы данных как редактируемую ER-модель не хранит |
| drawio-skill | нет | 10 419 | рисует произвольные схемы в draw.io, без импорта DDL и таблиц с типами столбцов | |
| MCP Toolbox for Databases | да | не нужна | 16 749 | подключает агента к живым базам и запросам, а ERD Editor правит только файл диаграммы |
Коротко о README
Основной README репозитория описывает сам ERD Editor и его расширения для VS Code, JetBrains и Obsidian. Отдельный README пакета `@dineug/erd-editor-mcp` объясняет подключение к Claude Code и Codex, режимы работы с открытым редактором и без него, правила чтения документов и таблицу инструментов по группам: сессия, таблицы, столбцы, связи, индексы, заметки, группы таблиц, настройки, импорт и пакетные правки.