CODESYS MCP Toolkit
MCP-сервер для CODESYS V3.5: Claude правит Structured Text, собирает проект настоящим компилятором и гоняет симуляцию.
- 131 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Записывает, переименовывает и удаляет объекты проекта CODESYS, а одно подтверждение инструмента покрывает и такие действия.
- Автосохранение по умолчанию записывает проект на диск после каждой правки.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/codesys-mcp-toolkitОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Записывает, переименовывает и удаляет объекты проекта CODESYS, а одно подтверждение инструмента покрывает и такие действия.
- Автосохранение по умолчанию записывает проект на диск после каждой правки.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер держит в фоне один сеанс CODESYS и дает агенту единый инструмент `codesys` с набором действий: открыть и создать проект, прочитать дерево объектов, найти код, записать или переименовать POU, методы, свойства, интерфейсы, DUT и GVL на Structured Text. Ошибки компиляции приходят с объектом, строкой и кодом, в том числе для кода, который пока никто не вызывает. Для проверки есть симуляция самого CODESYS: запуск, пошаговый прогон заданного числа циклов, чтение, запись и принудительная установка значений. Живая панель показывает дерево проекта, код по мере записи, результаты компиляции и кнопки Accept и Revert для каждой правки. Действие `batch` объединяет до 50 операций в один вызов.
Для кого. Инженерам по автоматизации, которые пишут программы ПЛК в CODESYS и хотят отдать Claude рутину на Structured Text с проверкой компилятором.
Подходит, если
- Нужно создать функциональный блок, вызвать его из `PLC_PRG`, собрать и убедиться в симуляции, что выход переключается.
- Проект большой, и агенту надо получить обзор: контуры, список ввода-вывода, дерево устройств и интерфейсы библиотек.
- Нужна правка кода с контролем: каждое изменение просматривают в панели и принимают или откатывают.
- Требуется пройти проект компилятором CODESYS и разобрать ошибки с номерами строк.
Не подходит, если
- Нужно править графические языки SFC, CFC, LD и FBD: версия 2 редактирует только Structured Text.
- Вы работаете на Linux или macOS: платформа сервера Windows.
- Нужна работа с реальным контроллером: сервер выходит онлайн только в симуляцию.
Пример запроса к агенту
Создай проект BlinkDemo.project, добавь функциональный блок, который раз в секунду переключает выход, вызови его из PLC_PRG, собери и докажи в симуляции, что выход переключается.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Нужны Windows, CODESYS V3.5 с дополнением Scripting (проверено на SP21 и SP22 со Scripting 4.2 и SP21 со Scripting 4.1, SP16 и новее должны работать) и Node.js 20 или новее. Schneider EcoStruxure Machine Expert пока не поддерживается. Холодный старт CODESYS занимает от одной до трех минут, следующие около десяти секунд. Графические объекты видны в дереве и читаются как PLCopenXML, но не редактируются. Одно подтверждение инструмента покрывает и действия, которые меняют или удаляют код, поэтому работайте с копией проекта или под контролем версий. Живая панель требует клиента с поддержкой MCP Apps.
Как отключить. Удалите блок codesys из `claude_desktop_config.json` и перезапустите клиент. Пакет снимает команда `npm uninstall -g @codesys/mcp-toolkit`. Сеанс CODESYS завершается через две минуты после отключения последнего клиента.
Частые вопросы
Как подключить CODESYS MCP Toolkit к Claude Desktop?
Установите пакет командой `npm install -g @codesys/mcp-toolkit` и добавьте в `claude_desktop_config.json` сервер с командой `codesys-mcp-tool` и аргументами `--codesys-path`, `--codesys-profile`, `--workspace`. Первые два необязательны: без них берется новейшая установка CODESYS.
Может ли сервер повредить реальный контроллер?
Нет, сервер не входит на контроллер и ничего на него не загружает. Онлайн-соединение есть только с симуляцией CODESYS, и каждый онлайн-вызов сначала проверяет, что режим симуляции включен.
Как отменить ошибочную правку агента?
При открытии проекта создается контрольная точка, а `revert_object` возвращает объект к ней вместе с методами и свойствами. В живой панели у каждой правки есть кнопки Accept и Revert.
Какие версии CODESYS поддерживаются?
Проверены SP21 и SP22 со Scripting 4.2 и SP21 со Scripting 4.1, SP16 и новее должны работать. Для нескольких версий добавьте по одной записи сервера на версию со своими `--codesys-path` и `--codesys-profile`.
Можно ли править ПЛК-код на графических языках?
Нет, версия 2 редактирует только Structured Text. Объекты SFC, CFC, LD и FBD видны в дереве проекта и читаются как PLCopenXML.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер, который один раз строит граф кода проекта и отдает агенту готовые ответы вместо повторного перечитывания файлов
Проект CODESYS в виде текстовых файлов для Git и LLM-агентов: экспорт, сборка, анализ кода на ST и тесты в симуляции
MCP-сервер, который строит граф кода: функции, классы, вызовы и маршруты, и отвечает на структурные запросы агента локально
Расширение VS Code поднимает локальный MCP-сервер: агент ищет символы, правит файлы и запускает команды в терминале редактора
MCP-сервер, который дает агенту читать файлы, искать по коду и запускать команды в рабочей папке
Инструменты разработки для Конструктора MCP серверов 1С
Инструменты для разработки — MCP Tools для Конструктора MCP серверов 1С
Четыре готовых MCP-инструмента для выполнения кода, запросов и диагностики в базе 1С, загружаемые в сторонний продукт Конструктор MCP серверов
Коротко о README
README показывает быстрый старт для Claude Desktop, таблицу действий по областям от проектов и чтения кода до симуляции, раздел о живой панели и список мер безопасности. Дальше идут параметры запуска, работа с несколькими версиями CODESYS и схема обмена с процессом CODESYS через файлы запросов и результатов.