cx-programmer-mcp

MCP-сервер для программного редактирования лестничных диаграмм (Ladder) OMRON CX-Programmer — без открытия графического интерфейса.

Работает с файлами .CXP / .CXT для ПЛК серий OMRON CJ/CP/CS.

Область действия: только программы, секции, мнемоника лестничных диаграмм, комментарии к цепям (rung) и таблица символов.
Не затрагивает: настройки PLC, таблицу ввода/вывода, сетевую конфигурацию, пароли и передачу в ПЛК.

Как это работает

OMRON документирует .CXP как сжатый вариант .CXT. .CXT — это текстовый формат, который CX-Programmer умеет импортировать и экспортировать. Этот сервер читает .CXP или .CXT, редактирует программу в памяти, затем сохраняет результат как .CXT / .CXP для проверки в CX-Programmer перед загрузкой в реальный ПЛК.

Использует Python MCP SDK v2 (MCPServer) с транспортом stdio.

Related MCP server: TwinCAT Validator MCP Server

Требования

• Python >= 3.10

• Менеджер пакетов uv

• Установленный CX-Programmer (для открытия .cxp и загрузки в ПЛК)

Установка

cd cx-programmer-mcp
uv sync
uv run cx-programmer-mcp

Настройка шаблона проекта

Встроенный шаблон (CJ2M CPU11)

В комплект входит родной шаблон CJ2M CPU11. Создайте пустой проект:

uv run python make_template.py

Другие модели ПЛК

У каждой модели ПЛК своя двоичная конфигурация. Для моделей, отличных от CJ2M CPU11:

1. Откройте CX-Programmer на вашем компьютере

2. Создайте новый пустой проект для вашей модели ПЛК (CP1L, CS1G и т.д.)

3. Сохраните его как .CXP или .CXT

4. Поместите файл в папку project/

5. Обновите make_template.py, указав ваш файл:

SRC = Path(__file__).parent / "project" / "your_blank_template.cxp"

6. Запустите make_template.py один раз

Пример программы

Пример лестничной диаграммы включён в комплект: project/example_basic_io.cxp

Он демонстрирует простой контроллер конвейера с:

• Ручным управлением выходом (удержание для включения)

• Автоматическим запуском по расписанию через RTC (настраивается через DM)

• Таймером длительности

• Защёлкой SET/RSET

• Аварийным сбросом

Чтобы пересобрать его из исходников:

uv run python make_template.py
uv run python build_program.py

Результат: project/example_basic_io.cxp — откройте в CX-Programmer для проверки и загрузки.

Проверка программы

uv run python review_program.py

Настройка MCP-клиента

Добавьте в конфигурацию MCP-клиента (Claude Desktop, Kiro, Cline и т.д.):

{
  "mcpServers": {
    "cx-programmer": {
      "command": "uv",
      "args": ["run", "cx-programmer-mcp"],
      "cwd": "ABSOLUTE_PATH_TO_THIS_FOLDER"
    }
  }
}

Пример для Windows:

"cwd": "C:\\Users\\yourname\\cx-programmer-mcp"

Необязательно — ограничьте доступ к файлам только нужными папками:

CX_MCP_ALLOWED_ROOTS=C:\PLC_Projects

Изменение расписания во время работы

Используйте CX-Programmer Online Mode → PLC Memory → DM Area:

Изменения вступают в силу сразу, без перезагрузки ПЛК.

Запуск тестов

uv run pytest -q

Доступные MCP-инструменты

Структура проекта

cx-programmer-mcp/
├── src/cx_programmer_mcp/     # MCP server and CXT library
│   ├── server.py              # MCP tool definitions
│   ├── cxt.py                 # CXT/CXP parser and editor
│   ├── ladder.py              # Mnemonic compiler and simulator
│   ├── diagnostics.py         # Program diagnostics
│   ├── recipes.py             # Reusable ladder patterns
│   ├── templates/             # Built-in PLC templates
│   │   └── CJ2M_CPU11.cxt     # Native CJ2M CPU11 template
│   └── ...
├── tests/                     # Test suite (16 tests)
├── project/                   # Output folder
│   └── example_basic_io.cxp   # Example ladder program
├── build_program.py           # Builds the example ladder program
├── write_build.py             # Regenerates build_program.py
├── make_template.py           # Generates blank template from base
├── review_program.py          # Prints program content to console
└── pyproject.toml

Примечания

• Всегда запускайте Program Check в CX-Programmer перед загрузкой в реальный ПЛК.

• Этот инструмент редактирует только логику программы — таблица ввода/вывода, настройки модулей и конфигурация ПЛК сохраняются как в шаблоне.

• Выходной .CXP совместим с CX-Programmer 9.73 для CJ2M CPU11.

• Для других моделей ПЛК предоставьте собственный пустой шаблон .CXP (см. Настройка шаблона проекта).