MCP-сервер управляемых форм 1С
1c-formsserver
MCP с 18 инструментами для генерации, валидации и конвертации управляемых форм 1С между форматами Конфигуратора, Managed и EDT
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Работает с текстом форм, которые сохраняются в проект самим пользователем, а не пишет в базу 1С напрямую
- HTTP-эндпоинт по умолчанию без авторизации, стоит ограничивать доступ сетью
Установка
Ручная установка
docker compose up -dРекомендуемый способ, сервер поднимется на порту 8011.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер понимает три формата описания формы 1С: Form.xml Конфигуратора, Managed и Form.form из EDT, определяет формат автоматически по namespace и умеет конвертировать между ними с сохранением семантики, включая приведение DataPath и типов. Можно сгенерировать типовую форму по шаблону (элемент справочника, документ, обработка), по произвольной JSON-спецификации или сразу из метаданных объекта, если подключен внешний EDT MCP. Валидация проверяет уникальность id, привязку DataPath к реквизитам и структуру, специфичную для каждого формата. Отдельная база примеров ищет похожие формы по тексту или по вектору, а интеграция с EDT добавляет получение реквизитов объекта и скриншот формы из WYSIWYG-редактора.
Для кого. Для 1С-разработчиков, которые хотят генерировать и переносить управляемые формы между Конфигуратором и EDT без ручной правки XML.
Подходит, если
- Нужно быстро сгенерировать типовую форму справочника или документа по описанию
- Нужно перенести форму из Конфигуратора в EDT или обратно с сохранением структуры
- Нужна валидация формы перед сохранением в проект, включая проверки специфичные для EDT
Не подходит, если
- Нужна автогенерация формы прямо из метаданных объекта: для этого обязателен отдельно запущенный EDT MCP
- Форма содержит нестандартную логику формы (обработчики событий), которую генератор не воспроизводит
- Нужен скриншот формы без запущенного EDT с WYSIWYG-редактором
Пример запроса к агенту
Сгенерируй форму документа ЗаказКлиента с шапкой Дата, Номер, Контрагент и табличной частью Товары в формате EDTОграничения
Интеграция с EDT (получение метаданных объекта, генерация из метаданных, скриншот формы) требует отдельно запущенного EDT MCP Server и переменной EDT_ENABLED=true, без него доступны только генерация по шаблону или спецификации и конвертация. Векторный поиск примеров форм это опциональная зависимость sentence-transformers, устанавливается отдельно флагом [search]. Конвертация managed в edt и обратно идет через промежуточный формат logform, а не напрямую.
Как отключить. Остановите контейнер командой docker compose down или процесс python -m mcp_forms и удалите запись 1c-forms из настроек MCP-клиента.
MCP
- Транспорт
- http, sse
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| EDT_ENABLED | Включает интеграцию с внешним EDT MCP Server, по умолчанию false. |
| EDT_MCP_URL | Адрес EDT MCP сервера, по умолчанию http://localhost:9999/sse. |
Проверка безопасности
- Работает с текстом форм, которые сохраняются в проект самим пользователем, а не пишет в базу 1С напрямую
- HTTP-эндпоинт по умолчанию без авторизации, стоит ограничивать доступ сетью
Коротко о README
README описывает MCP-сервер на FastMCP с 18 инструментами, сгруппированными по генерации, валидации, конвертации, схеме и справке, поиску примеров и интеграции с EDT. Приведена сравнительная таблица трех форматов форм, примеры параметров для каждого инструмента, четыре типовых сценария использования, таблица конфигурации через переменные окружения, структура проекта и список зависимостей включая опциональный поиск. Отдельно указано 91 тест. Лицензия MIT.
Частые вопросы
Нужно ли что-то вызвать перед первой генерацией формы?
Да, README прямо требует вызвать get_form_prompt в начале сессии, иначе модель не знает допустимые теги Form.xml.
Можно конвертировать managed напрямую в edt?
Нет, README указывает, что маршрут managed в edt идет через промежуточный формат logform.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything