openplc-engineering-mcp

Ein kleiner Python-MCP-Server, der domänenorientierte, schreibgeschützte Engineering-Operationen für OpenPLC bereitstellt.

Das Projekt ist eine frühe experimentelle Implementierung. Sein aktueller Zweck ist es, eine minimale, testbare Integrationsgrenze zwischen MCP-kompatiblen Agenten und OpenPLC-Editor-Projekten zu etablieren.

Architektur

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

Der Server verwendet das offizielle Model Context Protocol Python SDK und den stdio-Transport. Er modifiziert OpenPLC nicht und stellt keine generischen Dateisystem- oder Shell-Tools bereit.

Related MCP server: gx3-mcp-server

Anforderungen

• Python 3.12+

• uv

• Node.js/npm nur bei Verwendung von MCP Inspector (mcp dev verwendet npx)

Installation

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

Ausführen

Starten Sie den stdio-MCP-Server:

uv run openplc-engineering-mcp

Öffnen Sie ihn mit MCP Inspector:

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

Testen

uv run pytest

Die Tests verwenden die In-Memory-Schnittstelle Client(mcp) des offiziellen SDK, anstatt Tool-Funktionen direkt aufzurufen.

Aktuelle Tools

• get_server_info — berichtet über die aktuellen Fähigkeiten des Servers.

• get_project_structure — gibt die relevante Struktur eines OpenPLC-Editor-Projekts zurück.

• list_pous — listet Programme, Funktionsbausteine und Funktionen anhand des aktuellen OpenPLC-Editor-Projektlayouts auf.

Die OpenPLC-Projektprüfung folgt dem aktuellen Editor-Layout: project.json im Projektstamm, POUs unter pous/programs, pous/function-blocks und pous/functions, sowie die zugehörigen Geräte- und Datentyp-Speicherorte, die der Editor verwendet.

Umfang

Diese Version ist bewusst schreibgeschützt und experimentell. Sie umfasst keine Projektänderung, Kompilierung, Bereitstellung, Laufzeitsteuerung, Variablen-Forcing, Authentifizierung, HTTP-Transport oder uneingeschränkten Shell-/Dateisystemzugriff. Diese Fähigkeiten sollten nur hinzugefügt werden, wenn konkrete Anforderungen sie rechtfertigen.