openplc-engineering-mcp

Небольшой MCP-сервер на Python, предоставляющий предметно-ориентированные инженерные операции для OpenPLC в режиме только для чтения.

Проект находится на ранней экспериментальной стадии. Его текущая цель — установить минимальную, тестируемую границу интеграции между MCP-совместимыми агентами и проектами OpenPLC Editor.

Архитектура

MCP Host / LLM Agent
        |
        | MCP
        v
OpenPLC Engineering MCP
        |
        v
OpenPLC

Сервер использует официальный SDK Model Context Protocol для Python и stdio-транспорт. Он не изменяет OpenPLC и не предоставляет универсальные инструменты для работы с файловой системой или shell.

Related MCP server: gx3-mcp-server

Требования

• Python 3.12+

• uv

• Node.js/npm нужны только при использовании MCP Inspector (mcp dev использует npx)

Установка

git clone https://github.com/industrix-com-br/openplc-engineering-mcp.git
cd openplc-engineering-mcp
uv sync

Запуск

Запустите stdio MCP-сервер:

uv run openplc-engineering-mcp

Откройте его в MCP Inspector:

uv run mcp dev src/openplc_engineering_mcp/server.py --with-editable .

Тестирование

uv run pytest

В тестах используется внутрипроцессный интерфейс Client(mcp) из официального SDK, а не прямой вызов функций инструментов.

Текущие инструменты

• get_server_info — сообщает о текущих возможностях сервера.

• get_project_structure — возвращает актуальную структуру проекта OpenPLC Editor.

• list_pous — выводит списки программ, функциональных блоков и функций, используя текущую структуру проекта OpenPLC Editor.

Проверка проекта OpenPLC выполняется в соответствии с текущей структурой Editor: project.json в корне проекта, POU ниже pous/programs, pous/function-blocks и pous/functions, а также соответствующие расположения устройств и типов данных, используемые Editor.

Область применения

Эта версия намеренно является экспериментальной и работает только на чтение. Она не включает изменение проекта, компиляцию, развертывание, управление во время выполнения, форсирование переменных, аутентификацию, HTTP-транспорт или неограниченный доступ к shell и файловой системе. Эти возможности следует добавлять только тогда, когда для них появятся конкретные требования.