cx-programmer-mcp

Ein MCP-Server (Model Context Protocol) zum programmatischen Bearbeiten von OMRON-CX-Programmer-Ladder-Programmen - ohne die GUI zu öffnen.

Funktioniert mit .CXP- / .CXT-Dateien für OMRON-CJ/CP/CS-SPS-Baureihen.

Umfang: Nur Programme, Sektionen, Ladder-Mnemonics, Rung-Kommentare und Symboltabelle.
Berührt nicht: SPS-Setup, I/O-Tabelle, Netzwerkkonfiguration, Passwörter oder die Übertragung an die SPS.

So funktioniert es

OMRON dokumentiert .CXP als komprimierte Version von .CXT. .CXT ist ein textbasiertes Format, das CX-Programmer importieren/exportieren kann. Dieser Server liest .CXP oder .CXT, bearbeitet das Programm im Speicher und speichert das Ergebnis als .CXT/.CXP zur Überprüfung in CX-Programmer, bevor es auf eine echte SPS übertragen wird.

Verwendet das Python-MCP-SDK v2 (MCPServer) mit stdio-Transport.

Related MCP server: TwinCAT Validator MCP Server

Voraussetzungen

• Python >= 3.10

• uv-Seamaster

• CX-Programmer installiert (zum Öffnen der .cxp-Ausgabe und zum Übertragen auf die SPS)

Installation

cd cx-programmer-mcp
uv sync
uv run cx-programmer-mcp

Projektvorlagen-Setup

Integrierte Vorlage (CJ2M-CPU 11)

Eine native CJ2M-CPU11-Vorlage ist enthalten. Erzeugen Sie ein leeres Projekt:

uv run python make_template.py

Andere SPS-Modelle

Jedes SPS-Modell hat eine andere Binärkonfiguration. Für Modelle außer dem CJ2M-CPU11:

1. Öffnen Sie CX-Programmer auf Ihrem Rechner

2. Erstellen Sie ein neues leeres Projekt für Ihr SPS-Modell (CP1L, CS1G usw.)

3. Speichern Sie es als .CXP oder .CXT

4. Platzieren Sie die Datei im Ordner project/

5. Passen Sie make_template.py so an, dass es auf Ihre Datei verweist:

SRC = Path(__file__).parent / "project" / "your_blank_template.cxp"

6. Führen Sie make_template.py einmal aus

Beispielprogramm

Ein Beispiel-Ladder-Programm ist enthalten: project/example_basic_io.cxp

Es demonstriert eine einfache Förderband-/I/O-Steuerung mit:

• Manueller Ausgangssteuerung (Tippbetrieb)

• Zeitplangesteuertem automatischem Lauf über die Echtzeituhr (RTC, per DM konfigurierbar)

• Timer-basierter Laufdauer

• SET/RSET-Latch

• Not-Reset

Zur Neuerstellung aus dem GX:

uv run python make_template.py
uv run python build_program.py

Ausgabe: project/example_basic_io.cxp — öffnen Sie diese in CX-Programmer, um sie zu überprüfen und zu übertragen.

Programm überprüfen

uv run python review_program.py

MCP-Client-Konfiguration

Fügen Sie dies zu Ihrer MCP-Client-Konfiguration hinzu (Claude Desktop, Kiro, Cline usw.):

{
  "mcpServers": {
    "cx-programmer": {
      "command": "uv",
      "args": ["run", "cx-programmer-mcp"],
      "cwd": "ABSOLUTE_PATH_TO_THIS_FOLDER"
    }
  }
}

Windows-Example:

"cwd": "C:\\Users\\yourname\\cx-programmer-mcp"

Optional — belinken Sie die Dateizugriffe auf bestimmte Ordner:

CX_MCP_ALLOWED_ROOTS=C:\PLC_Projects

Zeitplanänderungen zur Laufzeit

Verwenden Sie in CX-Programmer Online-Modus → SPS-Speicher → DM-Bereich:

Die Änderungen werden ohne Neustart der SPS sofort wirksam.

Tests ausführen

uv run pytest -q

Verfügbare MCP-Tools

Projektstruktur

cx-programmer-mcp/
├── src/cx_programmer_mcp/     # MCP server and CXT library
│   ├── server.py              # MCP tool definitions
│   ├── cxt.py                 # CXT/CXP parser and editor
│   ├── ladder.py              # Mnemonic compiler and simulator
│   ├── diagnostics.py         # Program diagnostics
│   ├── recipes.py             # Reusable ladder patterns
│   ├── templates/             # Built-in PLC templates
│   │   └── CJ2M_CPU11.cxt     # Native CJ2M CPU11 template
│   └── ...
├── tests/                     # Test suite (16 tests)
├── project/                   # Output folder
│   └── example_basic_io.cxp   # Example ladder program
├── build_program.py           # Builds the example ladder program
├── write_build.py             # Regenerates build_program.py
├── make_template.py           # Generates blank template from base
├── review_program.py          # Prints program content to console
└── pyproject.toml

Hinweise

• Führen Sie vor der Übertragung auf eine echte SPS immer den Programmcheck in CX-Programmer aus.

• Dieses Werkzeug bearbeitet nur die Programmlogik — I/O-Tabelle, Unit-Einstellungen und SPS-Komfiguration werden unverändert aus der Vorlage übernommen.

• Die .CXP-Ausgabe ist binärkompatibel mit CX-Programmer 9.73 auf dem CJ2M-CPU11.

• Für andere SPS-Modelle stellen Sie eine eigene leere .CXP-Vorlage bereit (siehe Setup der Projektvorlagen).