1C Syntax Check MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
1C Syntax Check MCP
MCP-сервер для штатной проверки синтаксиса 1С:Предприятие 8 в пакетном режиме
Конфигуратора (/CheckModules, /CheckConfig). Работает с конфигурациями (.cf),
расширениями (.cfe), XML-выгрузками и существующими информационными базами.
Основной клиент — DeepSeek Harness (DSH); сервер также имеет CLI для CI.
Возможности
Tool | В DSH | Назначение |
|
| Проверить расширение |
|
| Проверить конфигурацию |
|
| Все расширения ИБ |
|
| Результат по |
|
| Отменить проверку |
|
| Платформа, версия, каталоги, ошибки |
Сервер создаёт временную файловую ИБ, загружает в неё конфигурацию/расширение,
запускает Конфигуратор с /Out, разбирает лог в диагностики
(module, line, column, message, context) и удаляет временные файлы.
Related MCP server: MCP:1C-DevTools
Требования
Windows 10/11 или Windows Server 2019/2022.
Node.js 20+.
Установленная платформа 1С 8.3.24+ (проверено на 8.3.27.1644) и лицензия.
На томе с
1cv8.exeдолжны работать короткие имена 8.3 (C:\PROGRA~1\...): сервер запускает Конфигуратор с verbatim-аргументами, а путь с пробелами требует короткого имени. Проверка:fsutil 8dot3name query C:.Доступ к
%LOCALAPPDATA%\1C\1cv8— платформа пишет туда служебные файлы.
Проверено на реальной 1С
Windows 10, платформа 8.3.27.1644:
.cfe—ok,exitCode 0;XML-расширение с заведомой ошибкой —
diagnostics,exitCode 101, сообщение «Ожидается выражение», строка 66, колонка 5;.cf—diagnostics,exitCode 101;-AllExtensionsна существующей ИБ — 72 диагностики;/CheckConfigс-Extension—ok;async-запуск (
waitSec: 1→get_run) иcancel_run— работают.
Установка
npm install
npm run build
npm testИнтеграционный smoke-тест на реальной 1С (нужны платформа и расширение):
$env:ONEC_PLATFORM_PATH = 'C:\Program Files\1cv8\8.3.27.1644\bin\1cv8.exe'
$env:ONEC_PLATFORM_VERSION = '8.3.27.1644'
node scripts/mcp-smoke.mjsПараметры запуска MCP
Путь и версия платформы обязательны и задаются только при запуске сервера — автопоиска нет. Tool-аргументы их не переопределяют.
Параметр | Env | Описание |
|
| Обязателен. Полный путь к |
|
| Обязателен. Версия вида |
|
| Корень временных информационных баз и логов. Должен быть записываемым; по умолчанию |
|
| Корни через |
|
| Пользователь ИБ, передаётся как |
— |
| Пароль ИБ; только env, в логах и |
|
| Таймаут шага проверки в секундах, по умолчанию 300; загрузка конфигурации — не менее 600 с |
|
| Сколько проверок выполнять одновременно; по умолчанию 2, у каждой своя временная ИБ |
|
| Не удалять |
|
| Не сверять |
Пример:
node dist/src/index.js `
--platform-path 'C:\Program Files\1cv8\8.3.27.1644\bin\1cv8.exe' `
--platform-version 8.3.27.1644 `
--work-dir 'C:\1c-check' `
--allowed-roots 'C:\dev;C:\dist'--work-dir
Корень для временных данных проверки. Из него строятся:
<work-dir>\runs\<runId>\ib— временная файловая ИБ, в которую загружается.cf,.cfeили XML;<work-dir>\runs\<runId>\*.log— логи шаговcreate,load-*,check-*;<work-dir>\logs\<runId>.log— постоянная копия лога, остаётся после удаления ИБ.
Что важно:
каталог должен быть записываемым для MCP-сервера и
1cv8.exe;временная ИБ может занимать сотни мегабайт — нужен запас места;
runs\<runId>удаляется после проверки, если не указан--keep-workspace;на служебные файлы 1С в
%LOCALAPPDATA%\1C\1cv8параметр не влияет;--allowed-rootsна--work-dirне распространяется.
--allowed-roots
Список разрешённых корней через ;. Проверяются входные пути запросов:
source.path (.cfe, .cf, каталог XML, существующая ИБ) и source.baseCfPath.
Проверка идёт до создания временной ИБ; путь вне корней отклоняется с
PATH_NOT_ALLOWED.
корень покрывает сам себя и все подкаталоги, граница проверяется по разделителю:
C:\1Cне покрываетC:\1C2;регистр не важен, относительные пути разрешаются от каталога запуска сервера;
это фильтр входных путей, а не песочница:
--work-dir,--platform-path, логи и служебные каталоги 1С им не ограничиваются;если не задан, используется текущий каталог сервера;
C:\фактически отключает ограничение, поэтому список лучше держать узким.
В текущем dsh/cordis.patch.yml: --work-dir — %TEMP%\1c-check,
--allowed-roots — C:\dev;C:\Users\user\Desktop;C:\1C.
Подключение к DeepSeek Harness
В папке dsh/ лежит config-only bundle:
dsh/package.json— манифест сdsh.bundle.patch;dsh/cordis.patch.yml— запись@deepseek-ai/dsh-mcp-clientсserverName: onec.
Порядок:
Соберите сервер (
npm run build) и поправьте вdsh/cordis.patch.ymlпути кdist/src/index.js,1cv8.exeи разрешённые корни.Установите bundle в профиль DSH:
plugin_manager, действиеinstall_bundle,target— абсолютный путь к папкеdsh/(например,C:\dev\mcp-syntax-checker\dsh). У bundle есть локаль, описание и иконка для карточки в Plugins.Перезагрузите конфигурацию DSH и проверьте
mcp__onec__environment.
Важно для DSH:
toolCallTimeoutMsпо умолчанию 60 с. ПоэтомуwaitSecв tool ≤ 55 с: если проверка не успела, tool вернётrunId, а результат забирается черезmcp__onec__get_run. Для синхронного ожидания поднимитеtoolCallTimeoutMs.DSH очищает унаследованное окружение от имён с
PASSWORD/SECRET/TOKEN, поэтому пароль задавайте явно вenvbundle (через!!jsили credentials).Сервер стартует без обращения к 1С;
failOnStartupError: trueбезопасен, ошибки платформы возвращаются в ответах tools.
CLI
# расширение
node dist/src/cli.js check-extension `
--cfe 'C:\dist\MyExt.cfe' --extension 'МоёРасширение' `
--platform-path 'C:\Program Files\1cv8\8.3.27.1644\bin\1cv8.exe' `
--platform-version 8.3.27.1644 `
--work-dir 'C:\1c-check' --allowed-roots 'C:\dist' `
--modes Server,ThinClient --json
# конфигурация
node dist/src/cli.js check-config --cf 'C:\dist\main.cf' --modes Server,ThinClient
# все расширения ИБ
node dist/src/cli.js check-all --ib 'C:\bases\MyBase'
# окружение
node dist/src/cli.js environmentКод возврата: 0 — ошибок нет, 1 — диагностики/сбой/таймаут, 2 — ошибка
конфигурации или аргументов.
Статусы результата
Статус | Значение |
| Проверка прошла, ошибок нет |
| Найдены ошибки/предупреждения (код 101) |
| Ошибка загрузки, запуска или конфигурации |
| Проверка не уложилась в таймаут |
| Запуск отменён |
В structuredContent возвращается не более 500 диагностик; полное число —
в diagnosticsTotal, признак обрезки — diagnosticsTruncated.
Ограничения
Нельзя проверить отдельный
.bslили фрагмент кода: платформа проверяет модули только в контексте конфигурации/расширения. Для сниппетов используйте BSL Language Server.Расширение с заимствованными объектами надо проверять против подходящей основной конфигурации (
baseCfPath), иначе возможны ложные ошибки.Конфигуратор — GUI-процесс; в CI запускайте от залогиненного пользователя.
Пароль 1С принимает только аргументом командной строки, он виден в списке процессов. Используйте отдельного пользователя с минимальными правами.
Разработка
src/
index.ts MCP entry (stdio)
cli.ts CLI
config.ts параметры запуска
platform.ts версия и короткий путь 1cv8.exe
core/check-service.ts
onec/args.ts сборка командной строки
onec/process.ts spawn, таймаут, taskkill
onec/log-parser.ts разбор /Out
onec/workspace.ts временная ИБ
mcp/server.ts tools
test/ unit-тесты и фикстуры логов
dsh/ config-only bundle для DSHTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Independent static checks for supported tag and alarm CSV import formats; no HMI or PLC access.
Validate JSON, YAML, XML and CSV with exact line/column errors and silent-corruption warnings.
Check ISO 20022 messages (pacs.008, pain.001, camt.053, seev.031) against schema and rules.
SQL validation, formatting, parsing, metadata extraction, linting, and security analysis.
Related MCP Servers
- FlicenseNot gradedqualityAmaintenanceMCP server that validates AI-generated 1C:Enterprise (BSL) code against the real platform API. Catches unknown enum values, wrong argument counts, and missing type members by parsing the platform syntax-helper (shcntx_ru.hbk) — independent Rust implementation with built-in expression validator.34-
- FlicenseNot gradedqualityAmaintenanceEnables 1C:Enterprise development with 74 tools for static analysis, code audit, query validation, EPF verification, and configuration management using local XML exports without a running database.2-
- AlicenseAqualityBmaintenanceEnables agents and MCP clients to perform static analysis and code navigation on 1C (BSL) codebases, including diagnostics, callers/callees, definitions, references, complexity metrics, and reindexing.9MIT
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to parse, build, edit, and validate 1C Data Conversion 2 exchange rules (ПравилаОбмена 2.01, registration and correspondent rules) against configuration metadata, including matching hints, XML round-trip editing, reverse-direction drafts, and pre-transfer checks.34MIT