edt-companion-mcp

HTTP MCP-сервер внутри 1C:EDT. OSGi-плагин поднимает локальный сервер на
http://127.0.0.1:6868/mcp (JSON-RPC 2.0 + MCP) и отдаёт 46 инструментов,
через которые AI-агент (Claude Code, Cursor, Cline, любой MCP-клиент) видит то
же, что видит сам EDT: типизированную метамодель, BSL-код с несохранёнными
правками открытых редакторов, структуру форм, СКД, XDTO, а также Eclipse Debug
API для запуска и отладки yaxunit-тестов.

Плагин работает только над тем workspace, который сейчас открыт в EDT —
отдельного процесса EDT/1С он не запускает.

Возможности

• Чтение метаданных и BSL: объекты конфигурации, формы (с extInfo и
  обработчиками), СКД, XDTO, предопределённые элементы, права ролей,
  подсистемы, defined-типы. Через BM-транзакции — видит несохранённые правки
  открытых редакторов, а не только диск.
• Поиск и навигация: текстовый поиск по BSL, резолв символов,
  cross-reference index (find_object_references), иерархия вызовов методов.
• Конфигурации на обычных формах: модули обычных (неуправляемых) форм
  читаются и ищутся, хотя EDT их в модель не поднимает — текст извлекается из
  контейнера Form.oform. Инструменты, которые такие формы не покрывают,
  сообщают об этом явно, а не отдают молчаливый нуль.
• Редактирование метаданных — единый инструмент edit_metadata: создание и
  удаление объектов, реквизиты, табличные части, формы (через штатный
  IFormGenerator), элементы форм, обработчики событий с авто-генерацией
  BSL-заглушек, права, подписки, defined-типы, XDTO-схемы, макеты, СКД.
  Принимает и конфигурации, и проекты-расширения.
• Заимствование в расширение: adoptObject / adoptChild / adoptModule
  через штатный IModelObjectAdopter.
• Валидация и сборка: маркеры EDT-валидации, rebuild_project, проверка
  запросов, headless-обновление ИБ (sync_database) без модального диалога.
• yaxunit + отладка: запуск тестов, чтение отчёта, точки останова с
  условием/hit-count, getState / getVariables / evaluate, пошаговое
  выполнение — через стандартный Eclipse Debug API.

Полный каталог инструментов, конвенции параметров и типовые сценарии — в
docs/llm-guide.md.

Требования

• 1C:EDT 2025.2 или 2026.1 (проверялось на 2025.2.5 / EDT core 26.0.1 и на
  2026.1.2 / EDT core 27.0.2).
• Java 17 (идёт в составе EDT).
• Открытый в EDT workspace с проектом конфигурации или расширения.

Установка

Через update-site (рекомендуется)

Стандартный механизм Eclipse. В 1C:EDT: Help → Install New Software…, в поле
Work with укажите адрес репозитория обновлений:

https://sekam68.github.io/edt-companion-mcp/

Отметьте фичу edt-companion-mcp, пройдите мастер и перезапустите EDT.
Обновления ставятся тем же путём (Help → Check for Updates).

Через drop-in jar (альтернатива)

1. Скачайте io.github.sekam68.edt.companion.mcp-<версия>.jar из раздела
   Releases.

2. Скопируйте jar в каталог dropins установки 1C:EDT. Типичный путь:

   <установка 1C:EDT>/components/1c-edt-<версия>-x86_64/dropins/
   

   (например C:/Program Files/1C/1CE/components/1c-edt-2025.2.5+2-x86_64/dropins/).
   У установок, развёрнутых 1cedtstart в отдельный каталог, это
   <каталог установки>/1cedt/dropins/ — например
   D:/1C/1cedtstart/installations/1C_EDT 2026.1/1cedt/dropins/.

3. Перезапустите 1C:EDT (при первой установке помогает разовый запуск с -clean).

Проверка

curl http://127.0.0.1:6868/health
→ {"status":"ok","tools":46,"workspace":"D:\\1C\\workspaces\\Демо",
   "workspaceName":"Демо","projects":["Демо","Демо.Расширение"]}

Если /health не отвечает — EDT не запущен либо bundle не активировался.

workspace / projects называют, какой именно EDT отвечает на этом порту, —
при двух запущенных экземплярах это единственный способ не спутать порты
(см. docs/multi-instance.md).

Порт по умолчанию — 127.0.0.1:6868. Меняется прямо в Window → Preferences →
edt-companion-mcp (поле «TCP-порт», применяется сразу, без перезапуска EDT).
Для headless/CI порт можно задать VM-аргументом -Dedt.yaxunit.mcp.port=<порт>
(в 1cedt.ini после -vmargs) или переменной окружения EDT_YAXUNIT_MCP_PORT —
они имеют приоритет над значением на странице настроек.

Подключение AI-агента

Пропишите сервер в .mcp.json проекта (или в конфигурации вашего
MCP-клиента):

{
  "mcpServers": {
    "edt-companion-mcp": {
      "type": "http",
      "url": "http://127.0.0.1:6868/mcp"
    }
  }
}

Протокол — JSON-RPC 2.0 через POST /mcp; поддержаны методы initialize,
tools/list, tools/call. Список инструментов и их параметры агент получает
через tools/list; человекочитаемый справочник — в
docs/llm-guide.md.

Конфигурации на обычных (неуправляемых) формах

EDT такую конфигурацию импортирует нормально, но обычную форму в модель не
поднимает: и раскладка, и модуль лежат в бинарном Form.oform в каталоге
формы, а API чтения этого контейнера EDT не предоставляет. На конфигурации
эпохи 8.2 это может быть половина кода — и молчаливое «совпадений нет» из
поисковых инструментов опаснее отсутствующей возможности, потому что читается
как «использований нет».

Плагин закрывает это с двух сторон.

Читает и правит модули. read_module_source, read_method_source и
get_module_structure принимают путь .../Forms/<Имя>/Module.bsl, которого на
диске нет: текст извлекается из контейнера, в ответе source:"oform" и путь к
Form.oform. search_in_code досматривает контейнеры отдельным проходом,
помечая совпадения источником. write_module_source по тому же пути правит
текст модуля внутри контейнера — EDT обычную форму не моделирует, а везёт файл
как есть и сравнивает с информационной базой.

Состав процедур менять можно, включая переименования: служебных процедур в
формах около трети. Но обработчик обычной формы привязан по имени — в
раскладке либо строкой в коде, — и за переименованием привязка не переезжает:
конфигурация соберётся, а событие молча перестанет срабатывать. Поэтому запись
проверяет исчезнувшие имена по обоим источникам и, если задет обработчик,
возвращает предупреждение с именем события и указанием перепривязать его в
конфигураторе. Строгий режим (handlerChanges: "refuse") отклоняет такие
правки вместо предупреждения. Раскладка формы остаётся только для
конфигуратора.

Не выдаёт неполноту за полноту. get_form_layout по обычной форме отдаёт
layoutAvailable:false с причиной вместо пустых секций, get_form_screenshot
отказывает сразу, find_object_references и get_method_call_hierarchy
добавляют блок coverage со счётчиками. get_config_properties отдаёт режим
запуска конфигурации (defaultRunMode, modalityUseMode,
interfaceCompatibilityMode, …) и счётчики форм по типу — этого хватает, чтобы
с первого вызова понять, с чем имеешь дело.

Режим — в Window → Preferences → edt-companion-mcp, «Обычные
(неуправляемые) формы»: по умолчанию авто, то есть применимость
определяется наличием Form.oform в проекте, и на конфигурациях с
управляемыми формами вывод инструментов не меняется. «Только чтение» запрещает
запись в контейнер, «не читать контейнеры» отключает и извлечение текста,
оставляя явные отказы с причиной; то же значение принимает переменная
EDT_COMPANION_ORDINARY_FORMS.

Цикл правки целиком — от чтения модуля до возврата изменений в EDT — в
docs/ordinary-forms.md.

Защита персональных данных (PII-редактор)

Опциональный output-фильтр: перед отправкой результата любого инструмента
агенту (в т.ч. в облачную модель) содержимое прогоняется через набор правил,
и обнаруженные ПДн заменяются на маску [redacted] или коррелируемый псевдоним
Физлицо#<hmac> (одинаковый вход → один токен, без раскрытия и без хранения
таблицы соответствий). По умолчанию выключен — включается осознанно на
базах с реальными ПДн.

Включается одним флагом в Window → Preferences → edt-companion-mcp —
«Фильтровать персональные данные (ПДн) в ответах инструментов» (применяется
сразу, перезапуск EDT не нужен). Остальное работает на разумных умолчаниях:
встроенный набор правил под 152-ФЗ (email, телефон, СНИЛС, ИНН) и случайный ключ
псевдонимайзера на запуск.

Флаг можно перекрыть переменной окружения EDT_COMPANION_PII
(on/1/true/yes) — приоритетнее галочки, удобно для CI/headless. Для
продвинутых сценариев доступны (только через env, в UI не выведены):
EDT_COMPANION_PII_SALT — постоянная соль для стабильных псевдонимов между
сессиями; EDT_COMPANION_PII_RULES — путь к своему JSON-набору правил.

Текущая версия применяет правила по содержимому значения (regex): email,
телефон +7…, СНИЛС, ИНН, паспортные/длинные числовые последовательности.
Формат правила: { "enabled", "scope": "VALUE", "countable", "representation", "regex" }
(countable:false — плоская маска, countable:true — псевдоним).

Каталог инструментов (46)

get_form_screenshot требует native-buffered рендера форм: добавьте в
1cedt.ini после строки -vmargs две строки
-DnativeFormLayoutRender=true и -DnativeFormBufferedLayoutRender=true
и перезапустите EDT. Без них буфер изображения пуст (форма рисуется в
нативное окно). Остальные инструменты в этих аргументах не нуждаются.
Аргументы живут в 1cedt.ini конкретной установки — после обновления
EDT на новую версию их нужно прописать заново.

get_method_call_hierarchy строит граф сам, а не через модельные
Method.callers / Method.callees — те объявлены transient и
заполняются только редакторским путём EDT, поэтому при чтении модуля
через BM read-транзакцию пусты. Границы методов берутся из AST (видны
несохранённые правки), имена разрешаются по индексу модулей workspace.
Глобальные функции платформы и вызовы через переменную/менеджер объекта
в граф не попадают — они перечислены в unresolvedCalls.

Когда не подходит

• Headless / CI / удалённая разработка без открытого EDT — сервер живёт
  внутри процесса EDT; без UI ряд операций (в т.ч. sync_database) недоступен.
• Редактирование тела существующего BSL-метода — плагин читает модули, ищет
  по коду, находит ссылки и дописывает заглушки обработчиков, но тело
  процедуры правит сам агент своими file-tools.

Лицензия

Использование бесплатно — в личных целях и внутри организации, без ограничения
по числу рабочих мест, в том числе в коммерческой разработке. Распространение,
изменение и восстановление исходного кода требуют разрешения правообладателя.
Полные условия — в файле LICENSE; там же сведения о сторонних
компонентах.

Результаты работы плагина — код и метаданные в ваших проектах — принадлежат
вам, никаких прав на них правообладатель не заявляет.