openplc-engineering-mcp

Un pequeño servidor MCP en Python que expone operaciones de ingeniería orientadas a dominio y de solo lectura para OpenPLC.

El proyecto es una implementación experimental temprana. Su propósito actual es establecer un límite de integración mínimo y comprobable entre agentes compatibles con MCP y proyectos de OpenPLC Editor.

Arquitectura

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

El servidor utiliza el SDK oficial de Model Context Protocol para Python y transporte stdio. No modifica OpenPLC ni expone herramientas genéricas de sistema de archivos o shell.

Related MCP server: gx3-mcp-server

Requisitos

• Python 3.12+

• uv

• Node.js/npm solo cuando se usa MCP Inspector (mcp dev usa npx)

Instalación

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

Ejecución

Inicie el servidor MCP stdio:

uv run openplc-engineering-mcp

Ábralo con MCP Inspector:

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

Pruebas

uv run pytest

Las pruebas usan la interfaz Client(mcp) en memoria del SDK oficial en lugar de llamar directamente a las funciones de herramienta.

Herramientas actuales

• get_server_info — informa las capacidades actuales del servidor.

• get_project_structure — devuelve la estructura relevante de un proyecto de OpenPLC Editor.

• list_pous — lista programas, bloques de función y funciones usando el diseño actual del proyecto de OpenPLC Editor.

La inspección de proyectos de OpenPLC sigue el diseño actual del Editor: project.json en la raíz del proyecto, POUs debajo de pous/programs, pous/function-blocks y pous/functions, además de las ubicaciones relacionadas de dispositivos y tipos de datos utilizadas por el Editor.

Alcance

Esta versión es intencionalmente de solo lectura y experimental. No incluye modificación de proyectos, compilación, despliegue, control en tiempo de ejecución, forzado de variables, autenticación, transporte HTTP ni acceso sin restricciones a shell/sistema de archivos. Esas capacidades deberían agregarse solo cuando requisitos concretos lo justifiquen.