HINWEIS:

Dies ist ein v35-Edition-Fork des Studio 5000 AI Assistant, der unabhängig gepflegt wird. Er verwendet standardmäßig Studio 5000 Logix Designer v35, unterstützt aber jede installierte Version über das --version-Flag des Setup-Skripts (siehe Auswahl deiner Studio-5000-Version unten). Dank an das ursprüngliche Projekt, auf dem dies basiert: rivie13/studio5000-AI-Assistant (standardmäßig v36). Dieses Repo ist ein Prototyp – du kannst es gerne forken und zu deinem eigenen machen.

🤖 Studio 5000 KI-gestützter PLC-Programmierassistent

Dieser revolutionäre MCP-Server (Model Context Protocol) transformiert die PLC-Programmierung durch KI-gestützte Codegenerierung, L5X-Routinenerstellung, echte .ACD-Dateigenerierung und nahtlose Studio-5000-Integration. Konvertiere natürlichsprachliche Spezifikationen direkt in funktionierende Kontaktplan-Logik und vollständige Studio-5000-Projekte!

⚡ TL;DR – Ein-Befehl-Setup

# 1. Get Python 3.12 (NOT 3.11!) from python.org
python --version  # Must show 3.12.x

# 2. Clone the repo
git clone https://github.com/ProJewks/THE_Studio5000_AI_Assistant_V35.git
cd THE_Studio5000_AI_Assistant_V35

# 3. Run the setup script — installs everything and writes your config for you
python setup.py

setup.py erkennt deine installierte Studio-5000-Version (Standard: v35), installiert requirements.txt, installiert das Logix-Designer-SDK-Wheel, falls es eines findet, generiert einsatzbereite MCP-Konfigurationsdateien mit den korrekten Pfaden für deinen Rechner und führt den integrierten Selbsttest aus. Siehe Auswahl deiner Studio-5000-Version, wenn du nicht v35 verwendest, und Was setup.py generiert für Hinweise, was du mit den erstellten Dateien tun sollst.

Das war's! ✅ Springe zu Konfiguration für Claude Desktop, wenn du es stattdessen von Hand einrichten möchtest, oder weise Claude Desktop/Claude Code einfach auf die Dateien hin, die setup.py bereits generiert hat.

Related MCP server: tiacommander-mcp

🔀 Auswahl deiner Studio-5000-Version

Dieser Fork verwendet standardmäßig v35, aber du bist nicht darauf festgelegt. setup.py durchsucht deinen Rechner nach jeder installierten Logix-Designer-Version und lässt dich wählen:

# Auto-detect and prompt interactively (default: v35 if present)
python setup.py

# Force a specific version, e.g. the upstream project's v36
python setup.py --version 36

# Non-interactive, accept every default (CI / scripted installs)
python setup.py --yes

# Skip prompts but still write straight into Claude Desktop's config
python setup.py --version 37 --write-claude-desktop --yes

Wenn eine Version nicht automatisch erkannt wird, greift das Skript auf den Standard-Rockwell-Installationspfad (...\Logix Designer\ENU\v<N>\Bin\Help\ENU\rs5000) für die von dir angegebene Nummer zurück – überschreibe ihn mit --doc-root auf dem Server selbst (siehe Schritt 5), falls deine Installation an einem nicht standardmäßigen Ort liegt.

📦 Was setup.py generiert

Jede der folgenden Dateien ist maschinenspezifisch (absolute Pfade, dein Python-Interpreter) und git-ignoriert – du kannst sie jederzeit neu generieren, indem du python setup.py erneut ausführst:

mcp_config.json (ohne .local) bleibt als einfache Vorlage zur Referenz im Repo – bearbeite sie nicht von Hand, führe stattdessen setup.py aus.

📚 Ressourcen für neue Teammitglieder

🎯 Vollständige Team-Anleitungen verfügbar:

• 📖 TEAM_USAGE_GUIDE.md – Vollständiger Workflow-Leitfaden mit echten Beispielen

• ⚡ QUICK_REFERENCE_CARD.md – Tägliche Befehle und Tastenkürzel

• 🔧 TEAM_TROUBLESHOOTING_GUIDE.md – Häufige Probleme und Lösungen

🚀 Schnellstart für Teammitglieder

Bereit, dieses Tool zu nutzen? Folge diesen Schritten:

Voraussetzungen ⚠️ KRITISCH

• Python 3.12 (NICHT 3.11 oder früher – das SDK funktioniert nicht!)

• Studio 5000 Logix Designer v35 oder neuer auf deinem Rechner installiert

• Windows-Betriebssystem (Studio-5000-SDK ist nur für Windows)

Installationsschritte

1. Python 3.12 überprüfen:

   python --version
   # Must show Python 3.12.x - if not, install Python 3.12 from python.org

2. Klonen und Setup ausführen:

   git clone https://github.com/ProJewks/THE_Studio5000_AI_Assistant_V35.git
   cd THE_Studio5000_AI_Assistant_V35
   python setup.py

   Dies installiert Abhängigkeiten, das SDK-Wheel und generiert deine Konfiguration in einem Schritt – siehe den TL;DR oben. Die Schritte 2–3 unten sind das manuelle, Schritt-für-Schritt-Äquivalent, falls du es lieber selbst machen möchtest.

3. Studio-5000-SDK installieren (für .ACD-Dateien) – nur nötig, wenn du setup.py überspringst:

   pip install "C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python\logix_designer_sdk-*-py3-none-any.whl"

4. Die Installation testen:

   python src/mcp_server/studio5000_mcp_server.py --test

   ✅ Sollte anzeigen: Dokumentation indiziert, SDK verfügbar, Tests bestanden

5. Bereit zur Nutzung! – Der Server erkennt deine Studio-5000-Installationspfade automatisch

Probleme? Siehe den Abschnitt Fehlerbehebung unten.

🚀 KI-gestützte Funktionen

🧠 Natürliche Sprache zu PLC-Code

• KI-Codegenerierung: Einfaches Englisch in funktionierende Kontaktplan-Logik umwandeln

  • „Starte den Motor, wenn der Startknopf gedrückt wird, und stoppe ihn, wenn der Stoppknopf gedrückt wird" → Vollständige Kontaktplan-Logik mit korrekter Start/Stopp-Verriegelung

• Intelligente Mustererkennung: Erkennt automatisch Start/Stopp-, Zeitgeber-, Zähler- und grundlegende E/A-Muster

• Intelligente Tag-Erstellung: Generiert automatisch passende E/A-Tags mit beschreibenden Namen

• Befehlsvalidierung: Validiert generierten Code gegen die offizielle Studio-5000-Dokumentationsdatenbank

📁 L5X-Projektgenerierung

• Projektstruktur-Erstellung: Generiert L5X-Projektdateien mit Programmen, Routinen und Tags (kann Routinen erstellen, die in bestehende Projekte importiert werden können, und leere L5X-Dateien zur manuellen Entwicklung)

• Unterstützung mehrerer Steuerungen: Unterstützung für verschiedene Allen-Bradley-Steuerungen (1756-L83E, 1756-L85E usw.)

• ⚠️ Aktuelle Einschränkung: Generierte L5X-Dateien können RLL-Formatierungsprobleme aufweisen, die manuelle Korrekturen erfordern

• Strukturierte Ausgabe: Die XML-Struktur folgt dem Studio-5000-Schema, muss aber möglicherweise validiert werden

• 💡 Best Practice: Für Projektvorlagen verwenden, dann Logik manuell in Studio 5000 hinzufügen

🏭 Echte .ACD-Projekterstellung

• Offizielle Studio-5000-SDK-Integration: Erstellt echte .ACD-Dateien mit dem offiziellen Rockwell-SDK

• Direkte Studio-5000-Kompatibilität: .ACD-Dateien öffnen sich direkt in Studio 5000 ohne Konvertierung

• ✅ Leere Projekterstellung: Saubere ACD-Vorlagen, bereit für die manuelle Entwicklung (ZUVERLÄSSIG)

• ⚠️ Vollständige Projekterstellung: Experimentell – SDK-Teilimport für MainProgram/MainTask (UNZUVERLÄSSIG)

• Versionskontrolle: Unterstützt verschiedene Studio-5000-Hauptversionen (Standard: v35)

• 💡 Empfohlen: Leere ACD-Erstellung + manueller L5X-Import-Workflow

🔍 Vektorbasierte semantische Suche

• Intelligente L5X-Analyse: Semantische Suche in massiven L5X-Dateien (getestet mit über 49.000 Zeilen)

• Verarbeitung im Produktionsmaßstab: Bewältigt komplexe industrielle Automatisierungsprojekte

• Intelligente Code-Einfügung: KI findet optimale Positionen für neue Logik in bestehenden Routinen

• Abhängigkeitsanalyse: Automatische Erkennung von Komponentenbeziehungen und -abhängigkeiten

• Mustererkennung: Versteht Förderbandsteuerung, Encoder-Logik, Fehlerbehandlung und Zeitgeber-Muster

• FAISS-Vektordatenbank: Blitzschnelle semantische Suche mit embeddingsbasierter Ähnlichkeit

📐 Analyse technischer Zeichnungen

• PDF-Technikzeichnungen: Technische Zeichnungen extrahieren und durchsuchen (P&IDs, elektrische Schaltpläne, Steuerungslogik-Diagramme)

• AutoCAD-Integration: CAD-generierte PDFs mit umfangreichem Text- und Vektorgrafikinhalt parsen

• Anlagenkontext: Automatisch Zeichnungen finden, auf die Anlagen-Tags und Systemkomponenten verweisen

• Vision-KI-Erweiterung: Erweiterte Analyse komplexer technischer Diagramme und Anlagenverbindungen

• Querverweis-Fähigkeit: Zeichnungen mit vorhandenem L5X-Code und Tag-Datenbanken verknüpfen für ein vollständiges Systemverständnis

📊 Erweitertes L5X-Analysesystem

• Echte Produktionstests: Verifiziert mit echten 2,9-MB-L5X-Dateien aus industriellen Systemen

• Komplexitätsbewertung: Automatische Bewertung der Routinenkomplexität und des Refactoring-Bedarfs

• Komponentenzuordnung: Verfolgt Zeitgeber, Zähler, Tags und ihre Verbindungen

• Präzise Modifikationen: Präzise Rung-Einfügung ohne Störung der vorhandenen Logik

• Professioneller Workflow: Schreibgeschützte Analyse mit SDK-gestützten Modifikationsmöglichkeiten

📚 Dokumentationszugriff

• Umfassende Befehlsdatenbank: Durchsucht die offizielle Studio-5000-Dokumentation

• Intelligente Suche: PLC-Befehle nach Name, Beschreibung, Kategorie oder Funktionalität finden

• Detaillierte Informationen: Umfassende Details zu Befehlssyntax, Parametern und Verwendung erhalten

• Kategorie-Durchsuchen: Befehle nach funktionalen Kategorien durchsuchen (Alarm, Math, Motion, Timer usw.)

• Sprachunterstützung: Informationen darüber, welche Programmiersprachen jeden Befehl unterstützen (Kontaktplan, ST, FBD)

• Echtzeit-Validierung: Sofortige Validierung mit offizieller Rockwell-Dokumentation

📋 Detaillierte Installationsanleitung

Voraussetzungen – ZUERST LESEN! ⚠️

🚨 KRITISCHE ANFORDERUNG: NUR Python 3.12

• Dieses Projekt ERFORDERT Python 3.12 – frühere Versionen schlagen fehl

• Das Studio-5000-SDK ist inkompatibel mit Python 3.11 und früher

• Überprüfe ZUERST deine Python-Version, bevor du fortfährst

Systemanforderungen:

• Python 3.12.x (Download von python.org)

• Studio 5000 Logix Designer v35 oder neuer installiert

• Windows-Betriebssystem (Studio-5000-SDK ist nur für Windows)

• Administratorrechte können für die Ersteinrichtung erforderlich sein

Schritt-für-Schritt-Einrichtung

Schritt 1: Python 3.12 installieren

1. Download: Gehe zu python.org und lade Python 3.12 herunter

2. Installation: Während der Installation „Add Python to PATH" AKTIVIEREN ✅

3. Überprüfen: Eingabeaufforderung öffnen und ausführen:

   python --version
   # Must show: Python 3.12.x (if not, restart command prompt)

Schritt 2: Projekt holen

1. Repository klonen:

   git clone https://github.com/ProJewks/THE_Studio5000_AI_Assistant_V35.git
   cd THE_Studio5000_AI_Assistant_V35

2. Bevorzugst du den Ein-Befehl-Weg? Führe jetzt python setup.py aus und springe zu Schritt 4 – es erledigt die Schritte 3 und 3.5 für dich, einschließlich der Auswahl deiner Studio-5000-Version. Die manuellen Schritte unten sind für alle, die die volle Kontrolle über jeden Teil haben möchten.

Schritt 3: Abhängigkeiten installieren (KRITISCH!)

1. Alle erforderlichen Pakete installieren:

   pip install -r requirements.txt

   Dies installiert:

   • Kernkomponenten: BeautifulSoup, XML-Verarbeitung, Async-Unterstützung

   • KI & Vektorsuche: PyTorch, sentence-transformers, FAISS-Vektordatenbank

   • Semantische Analyse: Vektor-Embeddings für Befehls- und L5X-Suche

   • Leistung: Optimierte Versionen für den Produktionseinsatz

   Wenn du Fehler erhältst, versuche:

   python -m pip install --upgrade pip
   pip install -r requirements.txt

   Hinweis: Vektordatenbank-Komponenten (torch, sentence-transformers, faiss-cpu) sind für die semantische Suche enthalten. Sie ermöglichen erweiterte L5X-Analyse- und Befehlsuche-Funktionen.

Schritt 3.5: Studio-5000-SDK installieren (KRITISCH für .ACD-Dateien!) 🚨

⚠️ TEAMMITGLIEDER MÜSSEN DIESEN SCHRITT AUSFÜHREN – Überspringe ihn nur, wenn du keine .ACD-Dateierstellung benötigst

1. Finde die SDK-Wheel-Datei in deiner Studio-5000-Installation:

   # Look for this file (version may vary):
   dir "C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python\logix_designer_sdk-*-py3-none-any.whl"

2. Installiere die SDK-Wheel-Datei:

   # Replace with your actual file path and version:
   pip install "C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python\logix_designer_sdk-2.0.1-py3-none-any.whl"

3. Alternative – wenn du die Wheel-Datei nicht finden kannst:

   # Navigate to the SDK directory and install from there:
   cd "C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python"
   pip install logix_designer_sdk-*-py3-none-any.whl

Ohne diesen Schritt: Dokumentation und L5X-Generierung funktionieren, aber die .ACD-Dateierstellung schlägt fehl!

Schritt 4: Deine Installation testen ✅

1. Den Testbefehl ausführen:

   python src/mcp_server/studio5000_mcp_server.py --test

2. Du solltest Folgendes sehen:

   • ✅ „Dokumentation erfolgreich indiziert" (500+ Befehle gefunden)

   • ✅ „SDK verfügbar: True" (wenn du die SDK-Wheel-Datei korrekt installiert hast)

   • ✅ „SDK verfügbar: False" (OK, wenn du die SDK-Installation übersprungen hast – die L5X-Generierung funktioniert trotzdem)

   • ✅ Beispiel-Suchergebnisse und Codegenerierungstests

3. Wenn „SDK verfügbar" False anzeigt, du die Wheel-Datei aber installiert hast:

   • Überprüfe, ob der Pfad der Wheel-Datei korrekt war

   • Versuche: python -c "import logix_designer_sdk; print('SDK OK')"

4. Wenn die Tests vollständig fehlschlagen, siehe den Abschnitt Fehlerbehebung

🎉 Du bist bereit, das Tool zu nutzen! 🎉

Der Server erkennt Ihre Studio 5000-Installationspfade automatisch. Springen Sie zum Abschnitt Konfiguration für Claude Desktop, um loszulegen!

Schritt 5: Umgebungsvariablen konfigurieren (nur für fortgeschrittene Benutzer)

⚠️ DIESEN SCHRITT ÜBERSPRINGEN – Nur erforderlich, wenn Studio 5000 an nicht standardmäßigen Speicherorten installiert ist

Option A: Über Windows-Umgebungsvariablen festlegen

• Systemeigenschaften öffnen → Umgebungsvariablen

• Diese Benutzer- oder Systemvariablen hinzufügen:

STUDIO5000_DOC_PATH=C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000
STUDIO5000_SDK_PATH=C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python
PYTHON312_PATH=C:\Users\YourUsername\AppData\Local\Programs\Python\Python312\python.exe

Option B: .env-Datei erstellen (im Projektstammverzeichnis):

STUDIO5000_DOC_PATH=C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000
STUDIO5000_SDK_PATH=C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python
PYTHON312_PATH=C:\Users\YourUsername\AppData\Local\Programs\Python\Python312\python.exe

4. Finden Sie Ihre Studio 5000-Pfade:

   Dokumentationspfad: Suchen Sie nach dieser Datei in Ihrer Studio 5000-Installation:

   <Studio5000_Install>\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000\17691.htm

   Häufige Speicherorte:

   • C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000

   • C:\Program Files\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000

   SDK-Pfad: Suchen Sie nach dem SDK-Python-Ordner:

   C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python

5. Testen Sie den Server:

   # Test with environment variables (recommended)
   python src/mcp_server/studio5000_mcp_server.py --test
   
   # Or test with explicit path
   python src/mcp_server/studio5000_mcp_server.py --doc-root "C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000" --test

   Eine erfolgreiche Ausgabe sollte Folgendes zeigen:

   • Dokumentationsindizierung (Hunderte von gefundenen Anweisungen)

   • Beispiel-Suchergebnisse

   • KI-Codegenerierungstest

   • SDK-Verfügbarkeitsstatus

Konfiguration für Claude Desktop

Wenn Sie python setup.py ausgeführt haben, ist dies bereits erledigt – es hat Ihre echten, korrekten Pfade (egal in welchen Ordner Sie geklont haben, egal welchen Windows-Benutzernamen Sie haben) in claude_desktop_config.snippet.json geschrieben oder sie direkt in die Claude-Desktop-Konfiguration eingefügt, wenn Sie --write-claude-desktop übergeben haben. Unten ist nichts von Hand auszufüllen.

Machen Sie es manuell? Fügen Sie Folgendes zu Ihrer Claude-Desktop-Konfigurationsdatei hinzu (normalerweise unter %APPDATA%\Claude\config.json zu finden). Ersetzen Sie YourUsername und den Ordnernamen durch den Ort, an dem Sie dieses Repository tatsächlich geklont haben – der Ordner heißt nur dann THE_Studio5000_AI_Assistant_V35, wenn Sie ihn mit dem Standardnamen geklont haben:

Windows-Konfiguration

Option A: Verwendung von Umgebungsvariablen (empfohlen)

{
  "mcpServers": {
    "studio5000-ai-assistant": {
      "command": "python",
      "args": [
        "C:\\Users\\YourUsername\\THE_Studio5000_AI_Assistant_V35\\src\\mcp_server\\studio5000_mcp_server.py"
      ],
      "cwd": "C:\\Users\\YourUsername\\THE_Studio5000_AI_Assistant_V35",
      "env": {
        "STUDIO5000_DOC_PATH": "C:\\Program Files (x86)\\Rockwell Software\\Studio 5000\\Logix Designer\\ENU\\v35\\Bin\\Help\\ENU\\rs5000",
        "STUDIO5000_SDK_PATH": "C:\\Users\\Public\\Documents\\Studio 5000\\Logix Designer SDK\\python"
      }
    }
  }
}

Option B: Verwendung von Befehlszeilenargumenten

{
  "mcpServers": {
    "studio5000-ai-assistant": {
      "command": "python",
      "args": [
        "C:\\Users\\YourUsername\\THE_Studio5000_AI_Assistant_V35\\src\\mcp_server\\studio5000_mcp_server.py",
        "--doc-root",
        "C:\\Program Files (x86)\\Rockwell Software\\Studio 5000\\Logix Designer\\ENU\\v35\\Bin\\Help\\ENU\\rs5000"
      ],
      "cwd": "C:\\Users\\YourUsername\\THE_Studio5000_AI_Assistant_V35"
    }
  }
}

Wichtige Hinweise:

• Ersetzen Sie YourUsername durch Ihren tatsächlichen Windows-Benutzernamen

• Passen Sie die Studio 5000-Pfade an Ihre Installation an

• Verwenden Sie Python 3.12 – geben Sie bei Bedarf den vollständigen Pfad an: "command": "C:\\Users\\YourUsername\\AppData\\Local\\Programs\\Python\\Python312\\python.exe"

Alternative: Verwendung der Cursor-IDE

Wenn Sie die Cursor-IDE verwenden, ist der MCP-Server standardmäßig verfügbar, wenn Sie in diesem Projektarbeitsbereich arbeiten. Der Server verwendet automatisch Umgebungsvariablen, sofern diese festgelegt sind, oder Sie können ihn manuell in den MCP-Einstellungen von Cursor konfigurieren. Für dieses Projekt wird die Verwendung der Cursor-IDE dringend empfohlen, einschließlich der Einrichtung über die Cursor-MCP-Einstellungen (mcp.json)

🛠️ Verfügbare KI-Tools

Nach der Konfiguration stehen diese leistungsstarken Tools in Ihren KI-Konversationen zur Verfügung:

🧠 KI-Codegenerierungstools

1. Ablaufsteuerungslogik generieren (Ladder Logic)

Tool: generate_ladder_logic Parameter:

• specification (string): Beschreibung des gewünschten PLC-Verhaltens in natürlicher Sprache

Funktionen:

• Mustererkennung: Erkennt automatisch Start/Stopp-, Timer-, Zähler- und grundlegende I/O-Muster

• Intelligente Tag-Generierung: Erstellt passende Tag-Namen und Datentypen

• Anweisungsvalidierung: Verwendet die Studio 5000-Dokumentationsdatenbank zur Validierung

Beispiel: "Erstellen Sie eine Logik, um einen Motor mit einem Startknopf zu starten und mit einem Stoppknopf zu stoppen"

2. L5X-Projekt erstellen

Tool: create_l5x_project Parameter:

• project_spec (Objekt): Projektspezifikation einschließlich:

  • name (string): Projektname

  • controller_type (string): Controller-Modell (z. B. "1756-L83E")

  • specification (string): Beschreibung der Logik in natürlicher Sprache

  • save_path (optionaler string): Dateipfad zum Speichern der L5X-Datei

Ausgabe: Vollständige Studio 5000-L5X-Projektdatei, bereit für den Import

3. Leere .ACD-Vorlage erstellen ✅

Tool: create_acd_project
Parameter:

• project_spec (Objekt): ACD-Projektspezifikation einschließlich:

  • name (string): Projektname

  • controller_type (string): Controller-Modell

  • major_revision (integer): Studio 5000-Version (Standard 36)

  • save_path (string): Dateipfad für die .ACD-Datei

Ausgabe: Leere .ACD-Datei mit dem offiziellen Studio 5000-SDK – bereit für die manuelle Entwicklung

⚠️ Wichtig: Erstellt nur LEERE Projekte. Behauptungen über "vollständige Projekte mit MainProgram/MainTask" sind unzuverlässig.

💡 Empfohlener Arbeitsablauf: Leeres ACD erstellen → Logik manuell in Studio 5000 entwickeln

4. Ablaufsteuerungslogik validieren ⚡ Schnelle und zuverlässige Validierung

Tool: validate_ladder_logic Parameter:

• logic_spec (Objekt): Enthält:

  • ladder_logic (string): Zu validierender Ablaufsteuerungslogik-Code

  • instructions_used (Array): Liste der verwendeten PLC-Anweisungen

🎯 Schnelles Validierungssystem:

Produktionsreife Schnellvalidierung ⚡

• Geschwindigkeit: 0,001–0,020 Sekunden

• Zuverlässigkeit: 100 % zuverlässig, keine externen Abhängigkeiten

• Erkennt: Syntaxfehler, ungültige Anweisungen, unbalancierte Klammern, Strukturprobleme, Logikmuster

• Anforderungen: Keine – funktioniert immer

• Abdeckung: Validiert gegen über 500 Studio 5000-Anweisungen

Ausgabe: Umfassender Validierungsbericht mit Fehlern, Warnungen und Vorschlägen

💡 Warum Schnellvalidierung besser ist: Sofortige Ergebnisse, 100 % Zuverlässigkeit, erkennt alle kritischen PLC-Programmierfehler und lässt sich nahtlos in Ihren Entwicklungsablauf integrieren. Keine komplexe Einrichtung erforderlich!

📚 Dokumentationstools

5. Anweisungen durchsuchen

Tool: search_instructions Parameter:

• query (string): Suchbegriff (Anweisungsname, Beschreibung, Funktionalität)

• category (optionaler string): Nach Anweisungskategorie filtern

Funktionen: Durchsucht die offizielle Studio 5000-Dokumentationsdatenbank

6. Anweisungsdetails abrufen

Tool: get_instruction Parameter:

• name (string): Exakter Anweisungsname (z. B. "TON", "MOV", "ADD", "PID")

Ausgabe: Vollständige Anweisungsinformationen einschließlich Syntax, Parameter, Beispiele und unterstützte Sprachen

7. Kategorien auflisten

Tool: list_categories Parameter: Keine (Dummy-Parameter erforderlich)

Ausgabe: Alle verfügbaren Anweisungskategorien (Alarm, Mathematik, Motion, Timer usw.)

8. Anweisungen nach Kategorie auflisten

Tool: list_instructions_by_category Parameter:

• category (string): Kategoriename

Ausgabe: Alle Anweisungen innerhalb der angegebenen Kategorie

9. Anweisungssyntax abrufen

Tool: get_instruction_syntax Parameter:

• name (string): Anweisungsname

Ausgabe: Detaillierte Syntax- und Parameterinformationen für die Anweisung

🔍 L5X-Analyse- und Vektorsuchtools

10. L5X-Inhalt durchsuchen

Tool: search_l5x_content Parameter:

• query (string): Suchanfrage in natürlicher Sprache (z. B. "Encoder-Impulszähler", "Stauerkennungslogik")

• project_file (string): Pfad zur zu durchsuchenden L5X-Datei

• max_results (integer): Maximale Anzahl der zurückzugebenden Ergebnisse (Standard: 5)

Funktionen: Semantische Suche in vorhandenen L5X-Dateien, um relevante Logikmuster zu finden

11. L5X-Projektstruktur analysieren

Tool: analyze_routine_structure Parameter:

• project_file (string): Pfad zur zu analysierenden L5X-Datei

• routine_name (optionaler string): Spezifische zu analysierende Routine

Ausgabe: Komplexitätsanalyse, Abhängigkeitszuordnung und Refactoring-Empfehlungen

12. Optimalen Einfügepunkt finden

Tool: find_insertion_point Parameter:

• project_file (string): Ziel-L5X-Datei

• new_logic_description (string): Beschreibung der einzufügenden Logik

• routine_name (string): Zielroutine für die Einfügung

Ausgabe: Empfohlene Rung-Position mit Konfidenzwert für die optimale Codeplatzierung

13. Intelligente Logikeinfügung

Tool: smart_insert_logic Parameter:

• project_file (string): Ziel-L5X-Datei

• routine_name (string): Zielroutine

• logic_specification (string): Beschreibung der neuen Logik in natürlicher Sprache

• insertion_point (integer): Rung-Position für die Einfügung

Funktionen: KI-generierte Logikeinfügung an optimalen Positionen mit Analyse des vorhandenen Codes

📚 SDK-Dokumentationssuchtools

14. SDK-Dokumentation durchsuchen

Tool: search_sdk_documentation Parameter:

• query (string): Suchanfrage in natürlicher Sprache zu SDK-Operationen

• limit (integer): Maximale Anzahl der zurückzugebenden Ergebnisse (Standard: 10)

Funktionen: Durchsucht die Studio 5000-SDK-Dokumentation mit semantischem Verständnis

15. SDK-Operationsdetails abrufen

Tool: get_sdk_operation_info Parameter:

• name (string): Name der SDK-Operation

• operation_type (optionaler string): Nach Typ filtern (Methode, Klasse, Enum, Beispiel)

Ausgabe: Detaillierte SDK-Operationsinformationen mit Beispielen und Parametern

📐 PDF-Technische-Zeichnungs-Tools

16. PDF-Zeichnungen indizieren

Tool: index_pdf_drawings Parameter:

• pdf_file_path (string): Pfad zur PDF-Datei mit technischen Zeichnungen

• force_rebuild (boolean): Erneute Indizierung des vorhandenen Caches erzwingen

• use_vision_ai (boolean): Erweiterte Vision-KI-Analyse aktivieren

Funktionen: Verarbeitet und indiziert technische PDF-Zeichnungen für die semantische Suche

17. Technische Zeichnungen durchsuchen

Tool: search_drawings Parameter:

• query (string): Suchanfrage in natürlicher Sprache (z. B. "Motor M001 elektrische Anschlüsse")

• drawing_type_filter (optionaler string): Nach Typ filtern (elektrisch, PID, Logik, io_list)

• equipment_filter (optionaler string): Nach Ausrüstungs-Tag filtern

Ausgabe: Rangfolge der Suchergebnisse mit Zeichnungskontext und Seitenverweisen

18. Ausrüstungskontext finden

Tool: find_equipment_context Parameter:

• equipment_tag (string): Ausrüstungskennung (z. B. "M001", "CV-001")

• context_type (optionaler string): Art des benötigten Kontexts (elektrisch, Prozess, Sicherheit)

Funktionen: Findet alle Zeichnungen und Dokumentationen, die sich auf bestimmte Ausrüstung beziehen

🎯 Drei leistungsstarke Ansätze für die PLC-Projekterstellung

Ihr MCP-Server unterstützt DREI verschiedene Ansätze für die PLC-Projekterstellung, die jeweils für unterschiedliche Anwendungsfälle optimiert sind:

🥇 Ansatz 1: L5X-Generierung + manueller Import (MIT EINSCHRÄNKUNGEN)

🎯 Generiert: L5X-Projektstruktur mit MainProgram und MainTask
⚠️ Ausgabe: L5X-Datei, die möglicherweise manuelle RLL-Formatierungskorrekturen benötigt
🎯 Am besten geeignet für: Projektvorlagen und grundlegende Strukturerstellung
🎯 Manuelle Schritte:

1. L5X-Vorlage generieren (30 Sekunden)

2. RLL-Formatierungsprobleme im Texteditor beheben

3. Korrigierte L5X in Studio 5000 importieren

Verwendung: "Erstellen Sie eine L5X-Projektvorlage für die Förderbandsteuerung"
Tool: create_l5x_project

⚡ Realitätscheck:

• ⚠️ Generierte L5X-Dateien können XML-Formatierungsprobleme aufweisen

• ✅ Gut für Projektstrukturvorlagen

• ✅ Nur die korrigierte Logik importieren, die Sie benötigen

• ✅ Professioneller Arbeitsablauf, sobald die Dateien validiert sind

🥈 Ansatz 2: Leere .ACD-Vorlagen (ZUVERLÄSSIG)

✅ Generiert: Leere .ACD-Projektdatei (saubere Vorlage)
✅ Ausgabe: Leeres Projekt, das direkt in Studio 5000 geöffnet wird
✅ Am besten geeignet für: Ausgangspunkt für die vollständig manuelle Entwicklung
🛠️ Manuelle Schritte: MainProgram und MainTask selbst erstellen, Logik manuell entwickeln

Verwendung: "Erstellen Sie eine leere .ACD-Vorlage für die manuelle Entwicklung"
Tool: create_acd_project

Warum das funktioniert:

• ✅ 100 % zuverlässige Erstellung leerer Projekte

• ✅ Keine komplexen SDK-Operationen, die fehlschlagen können

• ✅ Saubere Grundlage für die manuelle Entwicklung

🥉 Ansatz 3: Nur KI-Logikgenerierung (für bestehende Projekte)

🧠 Generiert: Professionelle Ablaufsteuerungslogik mit Validierung
🧠 Ausgabe: Copy-Paste-fertiger Ablaufsteuerungslogik-Code
🧠 Am besten geeignet für: Hinzufügen von Logik zu bestehenden Unternehmensprojekten
🧠 Manuelle Schritte: Generierte Logik in Ihre vorhandenen Routinen kopieren

Verwendung: "Generieren Sie Förderbandsteuerungslogik für mein bestehendes Projekt"
Tool: generate_ladder_logic

🎯 Aktueller Status und empfohlener Arbeitsablauf

Was tatsächlich funktioniert: ✅ KI-Logikgenerierung + leere ACD-Vorlagen + manuelle Entwicklung

Realistischer industrieller Arbeitsablauf:

1. KI-Logik generieren: "Förderbandsteuerung mit Stauerkennung erstellen" → Professioneller Kontaktplan-Logikcode

2. Leeres ACD erstellen: Saubere Projektvorlage, bereit für die Entwicklung

3. Manuelle Entwicklung: Logik in Studio 5000 kopieren, MainProgram/MainTask manuell erstellen

4. Produktionsreif: Voll funktionsfähige Logik, entwickelt mit KI-Unterstützung

Warum dies ehrlich und praktisch ist:

• ✅ 100 % zuverlässige Erstellung leerer ACD-Dateien - Keine komplexen Fehler

• ✅ KI-generierte Logik funktioniert - Gute Grundlage für die manuelle Entwicklung

• ✅ Professioneller Workflow - KI unterstützt, menschlicher Ingenieur validiert und implementiert

• ✅ Null Importprobleme - Kein defektes XML oder SDK-Komplikationen

Realitätscheck zu erweiterten Funktionen:

• ⚠️ L5X-Generierung: Erstellt Struktur, kann aber XML-Korrekturen vor dem Import erfordern

• ⚠️ Vollständige ACD-Projekte: Experimentelle SDK-Funktionen, die oft fehlschlagen

• ✅ Schnelle Validierung: 100 % zuverlässig zum Auffinden von Logikfehlern

• ✅ Vektorsuche: Funktioniert hervorragend zur Analyse bestehender Projekte

💡 Verwendungsbeispiele

Sobald der MCP-Server konfiguriert ist, können Sie Fragen stellen und Code generieren wie:

🧠 Beispiele für KI-Codegenerierung

• "Kontaktplanlogik erstellen, um einen Motor zu starten, wenn ein Starttaster gedrückt wird, und ihn zu stoppen, wenn ein Stopptaster gedrückt wird"

• "Ein Förderbandsteuerungssystem mit Start, Stopp und Not-Aus generieren"

• "Einen 5-Sekunden-Verzögerungstimer für ein Magnetventil erstellen"

• "Kontaktplanlogik für eine Pumpensteuerung mit Auto/Hand-Betrieb und Betriebsstundenzähler erstellen"

• "Eine Drei-Stationen-Montagelinie mit Verriegelungen und Sicherheitsstromkreisen entwerfen"

📁 Beispiele für Projekterstellung

• "Ein vollständiges .ACD-Projekt mit Förderbandsteuerungslogik und Sicherheitsverriegelungen erstellen" → Vollständiges .ACD mit MainProgram + Logik

• "Ein Motorsteuerungs-.ACD-Projekt für eine 1756-L83E-Steuerung generieren" → Gebrauchsfertige .ACD-Datei

• "Ein vollständiges Studio 5000 L5X-Projekt für Motorsteuerung mit Start/Stopp-Funktionalität erstellen" → L5X für den Import

• "Ein vollständiges L5X-Projekt für eine 3-Stationen-Montagelinie mit Sicherheitsverriegelungen erstellen" → Komplexe L5X-Projekte

• "Eine leere .ACD-Vorlage für die manuelle Entwicklung erstellen" → Saubere Vorlagendateien

📚 Beispiele für Dokumentation

• "Welche Timer-Anweisungen sind in Studio 5000 verfügbar?"

• "Zeig mir die vollständige Syntax und Parameter für die PID-Anweisung"

• "Welche Motion-Control-Anweisungen sind alle verfügbar?"

• "Wie verwende ich die GSV-Anweisung (Get System Value) im Kontaktplan?"

• "Was ist der Unterschied zwischen den Timer-Anweisungen TON, TOF und RTO?"

🔍 Beispiele für Validierung

• "Diese Kontaktplanlogik validieren: XIC(START)XIO(STOP)OTE(MOTOR)"

• "Prüfen, ob meine TON-Timer-Anweisungsverwendung mit diesen Parametern korrekt ist"

• "Verifizieren, dass meine Zählerlogik den Best Practices von Studio 5000 folgt"

🔍 Beispiele für L5X-Analyse und Vektorsuche

• "Mein bestehendes Förderbandprojekt nach Encoder-Impulszähllogik durchsuchen"

• "Alle timerbasierten Fehlererkennungsmuster in meiner L5X-Datei finden"

• "Die Komplexität meiner Sortierer-Tracking-Routine analysieren"

• "Wo sollte ich Stauerkennungslogik in meine bestehende Förderbandroutine einfügen?"

• "Alle VFD-Drehzahlsteuerungslogik in meinen Produktions-L5X-Dateien finden"

• "Die Abhängigkeitskarte für mein Encoder-Rückkopplungssystem anzeigen"

📚 Beispiele für SDK-Dokumentationssuche

• "Wie verwende ich die Methode LogixProject.partial_import_rungs_from_xml_file?"

• "Welche SDK-Methoden sind alle für die Tag-Manipulation verfügbar?"

• "Beispiele für die Verwendung des Studio 5000 SDK zur Projekterstellung zeigen"

• "SDK-Operationen im Zusammenhang mit Routineanalyse und -änderung finden"

📐 Beispiele für technische Zeichnungsanalyse

• "Das PDF der technischen Zeichnungen für mein Amazon-Förderbandsystemprojekt indizieren"

• "Alle elektrischen Verbindungen für Motor M001 in den Zeichnungen finden"

• "Die P&ID-Diagramme im Zusammenhang mit Förderband CV-001 anzeigen"

• "Welche Sicherheitsverriegelungen sind für die Weichen in den Zeichnungen dargestellt?"

• "Die Steuerlogikdiagramme für das Sortierer-Tracking-System finden"

• "Zeichnungen nach Stauerkennungssensor-Verdrahtung und -Verbindungen durchsuchen"

🏭 Praxisnahe Anwendungen

• "Kontaktplanlogik für eine Autowaschanlage mit 5 aufeinanderfolgenden Schritten generieren"

• "Ein vollständiges Projekt für eine Verpackungslinie mit Förderbandsteuerungen und Produktzählung erstellen"

• "Ein Temperaturregelungssystem mit PID-Regelkreis und Alarmbehandlung aufbauen"

Die KI verwendet automatisch die MCP-Server-Tools, um genaue, aktuelle Informationen basierend auf Ihrer tatsächlichen Studio 5000-Dokumentation bereitzustellen und funktionierenden SPS-Code zu generieren.

🔄 Manueller Import-Workflow (Empfohlen)

Schritt für Schritt: Von natürlicher Sprache zu funktionierendem SPS-Code

Szenario: Sie benötigen Förderbandsteuerungslogik mit Stauerkennung

Schritt 1: L5X-Projekt generieren

Fragen Sie Ihren KI-Assistenten:

"Ein vollständiges L5X-Projekt für Förderbandsteuerung mit Stauerkennung unter Verwendung von vorgelagerten und nachgelagerten Lichtschranken erstellen"

Ergebnis: Vollständige L5X-Datei mit:

• ✅ MainProgram und MainTask

• ✅ Professioneller Kontaktplanlogik

• ✅ Allen erforderlichen Tags mit Beschreibungen

• ✅ Validierten Anweisungen

Schritt 2: In Studio 5000 importieren

1. Studio 5000 öffnen mit Ihrem bestehenden Projekt (oder ein neues erstellen)

2. Gehen Sie zu: Datei → Importieren

3. Wählen Sie: Ihre generierte L5X-Datei

4. Wählen Sie: MainProgram importieren (oder bestimmte Komponenten)

5. Klicken Sie: Importieren

6. Fertig! - Funktionierende Logik, bereit zum Testen

Schritt 3: Anpassen und Testen

• Ordnen Sie Ihre E/A-Adressen den generierten Tags zu

• Testen Sie die Logik in Ihrer spezifischen Anwendung

• Ändern Sie sie nach Bedarf für Ihre Anforderungen

🏭 Für Firmenprojekte

• Verwenden Sie Ihre bestehenden Firmen-ACD-Vorlagen

• Generieren Sie nur die Logik, die Sie benötigen

• Importieren Sie in die etablierte Projektstruktur

• Behalten Sie Ihre Codierungsstandards und -praktiken bei

⚡ Profi-Tipps

• Generieren Sie mehrere L5X-Dateien für verschiedene Abschnitte (Sicherheit, Prozess, E/A)

• Importieren Sie selektiv - wählen Sie nur Programme, nur Tags oder nur bestimmte Routinen

• Versionskontrollfreundlich - L5X-Dateien funktionieren hervorragend mit Git

• Teamzusammenarbeit - Teilen Sie generierte L5X-Dateien mit Teammitgliedern

Fehlerbehebung

❗ Kritische Probleme

1. Python-Versionskonflikt

Problem: MCP-Server startet, aber SDK-Funktionen funktionieren nicht oder Sie erhalten Importfehler.

Lösung:

# Check your Python version
python --version
# Must show 3.12.x

# If not 3.12, install Python 3.12 and use full path in Claude config:
"command": "C:\\Users\\YourUsername\\AppData\\Local\\Programs\\Python\\Python312\\python.exe"

Warum: Das Studio 5000 SDK erfordert speziell Python 3.12. Frühere Versionen führen zu SDK-Importfehlern.

2. Dokumentationspfad nicht gefunden

Problem: "Hauptindexdatei nicht gefunden" oder "Keine Anweisungen gefunden"

Lösung - Dokumentationspfad finden:

1. Öffnen Sie den Datei-Explorer und suchen Sie nach: 17691.htm

2. Suchen Sie an diesen üblichen Orten:

   C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000\17691.htm
   C:\Program Files\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000\17691.htm
   C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v37\Bin\Help\ENU\rs5000\17691.htm

3. Legen Sie den korrekten Pfad fest (alles außer dem Dateinamen):

   # Via environment variable
   set STUDIO5000_DOC_PATH=C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000
   
   # Or via command line
   python src/mcp_server/studio5000_mcp_server.py --doc-root "C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000" --test

3. SDK nicht verfügbar

Problem: "Studio 5000 SDK nicht verfügbar" oder "SDK-Import fehlgeschlagen"

Häufigste Ursache: Sie haben die SDK-Wheel-Datei nicht installiert! ⚠️

Lösung:

1. 🚨 KRITISCH: Installieren Sie zuerst die SDK-Wheel-Datei:

   # Find and install the wheel file (most teammates miss this step!)
   pip install "C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python\logix_designer_sdk-*-py3-none-any.whl"

2. SDK-Installation prüfen:

   • Suchen Sie nach: C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python\

   • Wenn nicht vorhanden, installieren Sie Studio 5000 mit SDK-Komponenten neu

3. Überprüfen Sie, ob das SDK funktioniert:

   # Test if SDK is now available
   python -c "import logix_designer_sdk; print('SDK OK')"

4. Wenn es weiterhin fehlschlägt, legen Sie den SDK-Pfad fest:

   set STUDIO5000_SDK_PATH=C:\Users\Public\Documents\Studio 5000\Logix Designer SDK\python

⚠️ Häufige Einrichtungsprobleme

4. Server startet nicht

Symptome: Server stürzt sofort ab oder zeigt JSON-RPC-Fehler.

Lösungen:

• Python-Pfad in der Claude-Konfiguration prüfen - vollen Pfad zu Python 3.12 verwenden

• Arbeitsverzeichnis überprüfen - "cwd" sollte auf das Projektverzeichnis zeigen

• Dateiberechtigungen prüfen - Lesezugriff auf alle Projektdateien sicherstellen

• In Isolation testen:

  python src/mcp_server/studio5000_mcp_server.py --test

5. Umgebungsvariablen funktionieren nicht

Problem: Server verwendet trotz gesetzter Umgebungsvariablen weiterhin fest codierte Pfade.

Lösungen:

1. Eingabeaufforderung/IDE nach dem Setzen von Umgebungsvariablen neu starten

2. Variablennamen prüfen (Groß-/Kleinschreibung beachten):

   • STUDIO5000_DOC_PATH

   • STUDIO5000_SDK_PATH

   • PYTHON312_PATH

3. Umgebungsvariablen testen:

   echo %STUDIO5000_DOC_PATH%
   echo %STUDIO5000_SDK_PATH%

6. Konfigurationsprobleme mit Claude Desktop

Problem: MCP-Server erscheint nicht in Claude Desktop.

Lösungen:

1. config.json-Syntax prüfen - JSON-Validator verwenden

2. Claude Desktop nach Konfigurationsänderungen vollständig neu starten

3. Absolute Pfade verwenden - keine relativen Pfade in der Claude-Konfiguration

4. Claude-Protokolle unter %APPDATA%\Claude\logs\ prüfen

🔧 Erweiterte Fehlerbehebung

Schnelle Validierung: 100 % zuverlässig, null Einrichtung

✅ Aktueller Status: Schnelles Validierungssystem

Das System verwendet jetzt eine produktionsreife schnelle Validierung, die sofortige, zuverlässige Ergebnisse liefert:

Warum schnelle Validierung überlegen ist:

• ✅ Sofortige Ergebnisse: 0,001-0,020 Sekunden Validierungszeit

• ✅ 100 % Zuverlässigkeit: Keine externen Abhängigkeiten oder Dienstanforderungen

• ✅ Umfassende Abdeckung: Validiert gegen 500+ Studio 5000-Anweisungen

• ✅ Null Einrichtung: Funktioniert sofort auf jedem System

• ✅ Produktionsreif: Erkennt alle kritischen SPS-Programmierfehler

Validierungsabdeckung:

• ✅ Syntaxvalidierung: Ausgeglichene Klammern, korrektes Anweisungsformat

• ✅ Anweisungsvalidierung: Gegen den offiziellen Studio 5000-Anweisungssatz

• ✅ Strukturvalidierung: Logikmuster und Best Practices

• ✅ Fehlerberichterstattung: Detaillierte Fehlermeldungen mit Zeilennummern

• ✅ Warnsystem: Identifiziert potenzielle Probleme und Verbesserungen

Keine komplexe Einrichtung mehr erforderlich!

Das System hat sich über die SDK-Validierungsabhängigkeiten hinausentwickelt. Die schnelle Validierung bietet die gesamte Fehlererkennung, die für die professionelle SPS-Entwicklung erforderlich ist, ohne jegliche Einrichtungskomplexität, Dienstabhängigkeiten oder Zuverlässigkeitsprobleme.

🔧 Erweiterte Fehlerbehebung

7. Mehrere Python-Versionen

Wenn Sie mehrere Python-Versionen installiert haben:

# Use specific Python 3.12 executable
C:\Users\YourUsername\AppData\Local\Programs\Python\Python312\python.exe src/mcp_server/studio5000_mcp_server.py --test

# Or create virtual environment with Python 3.12
py -3.12 -m venv studio5000_env
studio5000_env\Scripts\activate
pip install -r requirements.txt

8. Unternehmens-/Netzwerkbeschränkungen

Problem: Zugriff auf Dokumentationsdateien aufgrund von Berechtigungen nicht möglich.

Lösungen:

• Beim Testen als Administrator ausführen

• Antivirus-Ausnahmen für Python- und Studio 5000-Verzeichnisse prüfen

• Netzwerklaufwerkszugriff überprüfen, wenn Studio 5000 auf einer Netzwerkfreigabe liegt

9. Studio 5000-Versionskompatibilität

Problem: Andere Studio 5000-Version als v35.

Lösungen:

• Dokumentationspfad an Ihre Version anpassen (v37, v38 usw.)

• major_revision-Parameter bei der .ACD-Projekterstellung aktualisieren

• SDK-Versionskompatibilität prüfen

🧪 Testbefehle

Überprüfen Sie Ihre Einrichtung mit diesen Befehlen:

# Test 1: Python version
python --version

# Test 2: Basic server test
python src/mcp_server/studio5000_mcp_server.py --test

# Test 3: Documentation path
dir "C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer\ENU\v35\Bin\Help\ENU\rs5000\17691.htm"

# Test 4: SDK availability (after installing wheel file)
python -c "import logix_designer_sdk; print('SDK Available')"

# Test 5: Environment variables
echo %STUDIO5000_DOC_PATH%
echo %STUDIO5000_SDK_PATH%

📞 Hilfe erhalten

Wenn Sie weiterhin Probleme haben:

1. Führen Sie den Testbefehl aus und erfassen Sie die vollständige Ausgabe

2. Prüfen Sie Ihre Python-Version und die Studio 5000-Installationspfade

3. Verifizieren Sie, dass alle Dateipfade existieren, bevor Sie Probleme melden

4. Geben Sie Ihre genaue Konfiguration an, wenn Sie um Hilfe bitten

Testen des Servers

Testanweisungen finden Sie in Schritt 4 im Installationshandbuch oben.

Technische Details

Architektur

Der MCP-Server besteht aus vier Hauptkomponenten:

1. Dokumentationsparser (studio5000_mcp_server.py):

   • Parst HTML-Dokumentationsdateien mit BeautifulSoup

   • Erstellt einen In-Memory-Index aller Anweisungen

   • Extrahiert Anweisungsnamen, Kategorien, Beschreibungen, Syntax und Parameter

   • Bietet schnelle Such- und Abruffunktionen

2. KI-Codeassistent (ai_assistant/code_assistant.py):

   • Verarbeitung natürlicher Sprache mit Mustererkennung

   • Kontaktplangenerierung für Start/Stopp-, Timer-, Zählermuster

   • Intelligente Tagerstellung mit geeigneten Datentypen

   • Codevalidierung mithilfe der Dokumentationsdatenbank

3. L5X-Generator (code_generator/l5x_generator.py):

   • XML-basierte L5X-Projektdateigenerierung

   • Vollständige Projektstruktur mit Programmen, Routinen und Tags

   • Studio 5000-Schemakonformität

   • Schön formatierte XML-Ausgabe

4. Studio 5000 SDK-Schnittstelle (sdk_interface/studio5000_sdk.py):

   • Erstellung echter .ACD-Projekte mit dem offiziellen Rockwell-SDK

   • Python 3.12-Anforderung für SDK-Kompatibilität

   • Generierung leerer Projektvorlagen

   • Direkte Studio 5000-Integration

MCP-Protokoll

• Folgt der Model Context Protocol-Spezifikation für die KI-Integration

• JSON-RPC 2.0-Kommunikation über stdin/stdout

• Tool-basierte Architektur mit 15+ verfügbaren Tools

• Vektorbasierte semantische Suchfunktionen

• Produktionsreife L5X-Dateianalyse

• Asynchrone Unterstützung für alle Operationen

📁 Projektstruktur

THE_Studio5000_AI_Assistant_V35/        # (folder name is whatever you clone it as)
├── setup.py                             # One-command installer — run this first
├── src/                                # Main source code
│   ├── mcp_server/
│   │   └── studio5000_mcp_server.py    # Main MCP server with AI features
│   ├── code_generator/
│   │   ├── l5x_generator.py            # L5X project file generation
│   │   └── templates/                  # L5X XML templates
│   ├── ai_assistant/                   # Enhanced AI assistance
│   │   ├── code_assistant.py           # AI-powered natural language processing
│   │   ├── enhanced_main_assistant.py  # Production-ready AI assistant
│   │   ├── mcp_integration.py          # MCP protocol integration
│   │   └── warehouse_automation_patterns.py # Industrial automation patterns
│   ├── sdk_interface/
│   │   └── studio5000_sdk.py           # Real Studio 5000 SDK integration
│   ├── documentation/                  # Vector-powered documentation search
│   │   ├── instruction_vector_db.py    # Instruction search vector database
│   │   └── instruction_mcp_integration.py # MCP tools for instruction search
│   ├── l5x_analyzer/                   # Advanced L5X file analysis
│   │   ├── l5x_vector_db.py           # L5X semantic search system
│   │   ├── l5x_mcp_integration.py     # L5X analysis MCP tools
│   │   └── sdk_powered_analyzer.py    # SDK-enhanced L5X analysis
│   ├── sdk_documentation/              # SDK documentation search
│   │   ├── sdk_vector_db.py           # SDK documentation vector search
│   │   ├── sdk_doc_parser.py          # SDK documentation parser
│   │   └── mcp_sdk_integration.py     # SDK documentation MCP tools
│   ├── tag_analyzer/                   # Tag analysis and management
│   │   ├── tag_vector_db.py           # Tag-based vector search
│   │   ├── csv_tag_parser.py          # CSV tag file parsing
│   │   └── tag_mcp_integration.py     # Tag analysis MCP tools
│   └── verification/                   # Code validation system
│       ├── sdk_verifier_clean.py      # Fast validation (production)
│       └── sdk_verifier.py           # Legacy SDK validation (deprecated)
├── *_vector_cache/                     # Vector database cache directories
│   ├── instruction_vector_cache/       # Instruction search cache
│   ├── l5x_vector_cache/              # L5X analysis cache
│   ├── sdk_vector_cache/              # SDK documentation cache
│   └── tag_vector_cache/              # Tag analysis cache
├── examples/                           # Example generated projects
├── docs/                              # Additional documentation
├── requirements.txt                    # Python dependencies (includes vector DB)
├── mcp_config.json                    # Sample MCP configuration for Claude
└── README.md                          # This comprehensive documentation

Schlüsseldateien

• Hauptserver: src/mcp_server/studio5000_mcp_server.py (Haupt-MCP-Server mit 15+ Tools)

• KI-Assistent: src/ai_assistant/enhanced_main_assistant.py (produktionsreifer KI-Assistent)

• L5X-Generator: src/code_generator/l5x_generator.py (erstellt importierbare L5X-Dateien)

• L5X-Analysator: src/l5x_analyzer/l5x_vector_db.py (semantische Suche in L5X-Dateien)

• Schnelle Validierung: src/verification/sdk_verifier_clean.py (Produktionsvalidierungssystem)

• SDK-Schnittstelle: src/sdk_interface/studio5000_sdk.py (erstellt echte .ACD-Dateien)

• Vektordatenbanken: *_vector_cache/-Verzeichnisse (FAISS-basierte semantische Suche)

• Konfiguration: Umgebungsvariablen oder Befehlszeilenargumente

Mitwirken

Aktuelle Fähigkeiten – EHRLICHE EINSCHÄTZUNG

✅ Was tatsächlich funktioniert (produktionsreif):

• ✅ Offizielle Studio-5000-Dokumentationsanalyse (HTML mit Vektorsuche)

• ✅ KI-gestützte Erzeugung von Kontaktplan-Text (gute Grundlage für manuelle Entwicklung)

• ✅ Erstellung leerer .ACD-Dateien (zuverlässige SDK-basierte Vorlagenerzeugung)

• ✅ Schnelles Validierungssystem (0,001 s Antwortzeit, 100 % zuverlässig)

• ✅ Vektorbasierte semantische Suche (FAISS-basiert, produktionsreif)

• ✅ L5X-Dateianalyse (getestet mit Dateien mit über 49.000 Zeilen)

• ✅ SDK-Dokumentationssuche (umfassende Methodendatenbank)

• ✅ Mustererkennung (Start/Stopp-, Timer-, Zähler-Muster)

⚠️ Was teilweise funktioniert (manuelle Korrekturen erforderlich):

• ⚠️ Erzeugung von L5X-Projektdateien (erstellt Struktur, aber RLL-Formatierungsprobleme)

• ⚠️ Vollständige ACD-Erstellung (experimentelle SDK-Teilimportfunktionen)

• ⚠️ Intelligente Code-Einfügung (Analyse funktioniert, Einfügung ist SDK-abhängig)

🔧 Was entwickelt werden muss:

• 🔧 Korrekte RLL-XML-Erzeugung (gibt derzeit Rohtext in CDATA aus)

• 🔧 Zuverlässiger SDK-Teilimport (komplex und fehleranfällig)

• 🔧 End-to-End-Projektautomatisierung (erfordert derzeit manuelle Schritte)

Zukünftige Verbesserungsmöglichkeiten

Hohe Priorität (abgeschlossen! ✅):

• ✅ Vollständige SDK-Integration: ABGESCHLOSSEN! Vollständige Programm-/Aufgabenerstellung jetzt implementiert

• ✅ Routine-Import/-Export: ABGESCHLOSSEN! Nutzung der SDK-Teilimportfunktionalität

• ✅ Erstellung der Programmstruktur: ABGESCHLOSSEN! Erstellt automatisch MainProgram und MainTask

• Tag-Verwaltung: Implementierung von SDK-Tag-Erstellungs- und -Verwaltungsoperationen (TODO)

• Erweiterte Projektoperationen: Build-, Upgrade- und Bereitstellungsautomatisierung (TODO)

Mittlere Priorität (Funktionserweiterung):

• Zusätzliche Sprachunterstützung: Erzeugung von Structured Text (ST) und Funktionsblockdiagramm (FBD)

• Erweiterte Mustererkennung: Komplexere industrielle Automatisierungsmuster

• ✅ SDK-Dokumentationsverbesserung: ABGESCHLOSSEN! Parser findet jetzt 63 LogixProject-Methoden + 39 Beispiele = 102+ Operationen (vorher 22)

• Erweiterte Validierung: Statische Analyse und Prüfung bewährter Verfahren

Niedrigere Priorität (erweiterte Integration):

• Mehrere Studio-5000-Versionen: Dynamische Versionserkennung und Kompatibilität

• Integrationserweiterungen: Unterstützung für FactoryTalk View, RSLinx und andere Rockwell-Tools

• Cloud-Bereitstellung: Webbasierte Schnittstelle für Teamzusammenarbeit

• Caching-System: Verbesserte Leistung für große Dokumentationssätze

🎯 Der ehrliche Wert: KI-gestützter Entwicklungsablauf

Das System bietet wertvolle KI-Unterstützung für die SPS-Entwicklung:

• ✅ KI-Logikerzeugung: Natürliche Sprache in Kontaktplan-Text umwandeln (FUNKTIONIERT GUT)

• ✅ Leere ACD-Vorlagen: Saubere Projektdateien, bereit für manuelle Entwicklung (ZUVERLÄSSIG)

• ⚠️ L5X-Strukturerstellung: Erstellt Projektvorlagen, die möglicherweise Formatierungskorrekturen benötigen (TEILWEISE)

• ✅ Schnelle Validierung: Sofortige Syntax- und Befehlsprüfung (PRODUKTIONSREIF)

• ✅ Vektorsuche: Bestehende Projekte semantisch analysieren (PRODUKTIONSREIF)

Sie können fragen: „Generieren Sie Förderband-Steuerlogik mit Stauerkennung" und erhalten hochwertigen Kontaktplan-Code als Grundlage für die manuelle Entwicklung. Die KI unterstützt, aber menschliche Ingenieure müssen die endgültige Lösung weiterhin implementieren und validieren.

Entwicklungseinrichtung

1. Repository forken

2. Python 3.12 und Abhängigkeiten installieren

3. Umgebungsvariablen für Ihre Studio-5000-Installation einrichten

4. Tests ausführen, um die Funktionalität zu überprüfen

5. Pull-Requests mit klarer Dokumentation einreichen

Lizenz und Rechtliches

Wichtige rechtliche Informationen:

• Dieses Projekt wird wie besehen für Bildungs- und Entwicklungszwecke bereitgestellt

• Studio 5000, Logix Designer, ControlLogix und Allen-Bradley sind Marken von Rockwell Automation, Inc.

• Diese Software ist nicht mit Rockwell Automation verbunden, wird von ihr nicht unterstützt oder befürwortet

• Benutzer müssen gültige Studio-5000-Lizenzen besitzen, um die SDK-Funktionen zu nutzen

• Generierter Code und Projekte sollten vor der Verwendung in Produktionsumgebungen von qualifiziertem Personal validiert werden

Haftungsausschluss: Dieses Tool unterstützt bei der SPS-Programmierung, ersetzt jedoch nicht die ordnungsgemäßen technischen Verfahren, Sicherheitsanalysen oder Konformitätsprüfungen, die für industrielle Automatisierungssysteme erforderlich sind.