TIA Portal MCP

MCP-сервер дает агенту работать с проектом Siemens TIA Portal V21: читать блоки ПЛК, теги, сеть и HMI и вносить защищенные правки.

  • 124 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Широкий доступ

Почему такой уровень

  • В режимах `read-write` и `full` агент меняет блоки, теги, сеть и HMI промышленного проекта.
  • Правки не откатываются при сбое, а ошибка в логике ПЛК бьет по оборудованию после загрузки.
Все причины и проверки

czarnak/tia-portal-mcp

Установка

Ручная установка

dotnet tool install -g TiaMcpServer

Затем `tia-mcp doctor` проверяет окружение, а `tia-mcp install claude-code` регистрирует сервер в режиме `read-only`.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • В режимах `read-write` и `full` агент меняет блоки, теги, сеть и HMI промышленного проекта.
  • Правки не откатываются при сбое, а ошибка в логике ПЛК бьет по оборудованию после загрузки.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер подключает агента к запущенному TIA Portal через Siemens Openness API. По умолчанию действует режим `read-only` с восемью инструментами: чтение блоков и типов ПЛК, таблиц тегов, перекрестных ссылок, конфигурации оборудования и сети, объектов WinCC Unified HMI, дерево проекта и статус. Режим `read-write` добавляет до девятнадцати инструментов: `plc_write`, `network_write`, `hmi_write`, `vci_write`, компиляцию `compile_check` и жизненный цикл проекта (открыть, создать, сохранить, заархивировать, закрыть). Записи проходят через единый защищенный конвейер, а `dryRun:true` показывает последствия без изменений. Запуска и остановки ПЛК нет. Работа идет через отдельный процесс на .NET Framework 4.8, потому что сборки Siemens не работают в .NET 10.

Для кого. Инженерам АСУ ТП, которые программируют ПЛК Siemens в TIA Portal V21 и хотят разбирать проекты вместе с агентом.

Подходит, если

  • Нужно выгрузить логику блока и найти, где используется тег, через перекрестные ссылки.
  • Перед правкой проекта хотят увидеть последствия через `dryRun:true`.
  • Сеть и адреса ввода-вывода сверяют с таблицами тегов ПЛК.
  • После изменений проверяют компиляцию и читают сообщения компилятора.

Не подходит, если

  • Компьютер работает не на Windows или без TIA Portal V21.
  • Нужно управлять запуском и остановкой ПЛК.
  • Проект содержит классический WinCC, который сервер только перечисляет.

Пример запроса к агенту

Привяжись к открытому проекту, покажи дерево, найди все перекрестные ссылки на тег Motor_Run и выведи результат без записи.

MCP

Транспорт
stdio
Авторизация
не нужна

Переменные окружения

TIA_MCP_PROJECT_PATH
Абсолютный путь к проекту `.ap21` или `.amc21`, к которому привязывается сервер.

Ограничения

Работает только на Windows с TIA Portal V21 и включенным Openness; пользователь Windows состоит в группе `Siemens TIA Openness`. Для инструмента нужны .NET SDK 10.0.400 или новее и среда выполнения .NET Framework 4.8. Библиотеки Siemens сервер берет из локальной установки и в пакет не включает. Записи не откатываются при сбое: выполнение останавливается на первом неудачном пункте, поэтому перед повтором перечитайте состояние. Конфигурация оборудования служит инженерными данными и не подтверждает ввод установки в эксплуатацию.

Как отключить. Удалите запись сервера в клиенте и выполните `dotnet tool uninstall -g TiaMcpServer`. Журнал аудита лежит в `%LOCALAPPDATA%\TiaMcpServer\audit` и очищается отдельно.

Частые вопросы

Как подключить сервер к Claude Code?

Установите инструмент командой `dotnet tool install -g TiaMcpServer`, проверьте окружение через `tia-mcp doctor` и зарегистрируйте сервер: `tia-mcp install claude-code`. Поддерживаются также Codex, OpenCode и MiMoCode.

Чем отличаются режимы доступа?

`read-only` содержит восемь инструментов чтения. `read-write` добавляет правки и жизненный цикл проекта с запросом на каждый вызов, а `full` выполняет те же вызовы без запроса.

Что делает `tia-mcp doctor`?

Команда проверяет версию Windows, среды .NET, установку TIA Portal, сборки Openness, членство в группе и совместимость узла с процессом. Результат называет недостающие компоненты.

Можно ли запускать и останавливать ПЛК?

Нет. В сервере нет операций запуска и остановки ПЛК, а токенов безопасности больше нет: защита идет через режимы доступа и защищенный конвейер записи.

Где хранится журнал аудита?

В `%LOCALAPPDATA%\TiaMcpServer\audit`. Каждый вызов записи, включая предпросмотры и отказы, попадает в аудит с признаком подтверждения.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

MCP-сервер для Siemens TIA Portal: агент читает программу ПЛК, блоки, теги и ссылки; правки включаются флагом.

MCP-серверРасширенный доступ135Звезды репозитория

Плагин для автоматизации Siemens TIA Portal: скиллы Python Scripting и Openness API плюс MCP-сервер с документацией

ПлагинРасширенный доступ89Звезды репозитория

MCP-сервер для управления Windows: агент открывает приложения, кликает и печатает, читает состояние окон и интерфейса, работает с файлами и PowerShell

MCP-серверШирокий доступ11,6 тыс.Звезды репозитория

NX MCP подключает агента к Siemens NX: 16 типизированных инструментов для деталей, эскизов, выдавливания и экспорта STEP.

MCP-серверРасширенный доступ173Звезды репозитория

MCP-сервер и CLI wincli: агент управляет окнами Windows по именам кнопок и полей через UI Automation, без координат скриншота

MCP-серверШирокий доступ131Звезды репозитория

MCP-сервер Power Platform: 312 инструментов для потоков, приложений, Dataverse и Power Pages, управление обычными словами.

MCP-серверШирокий доступ103Звезды репозитория

Коротко о README

README подробно описывает инструменты, режимы доступа, ограничения и устройство из двух процессов. Установка идет через глобальный инструмент .NET, подключение к клиентам автоматизирует `tia-mcp install`.

Бейдж для README

Сообщить о проблеме