MCP Server TIA Portal
spatenimgarten/mcp-server
Integração de IA com Siemens TIA Portal para automação de engenharia
Ver no GitHubServidor MCP que integra Claude e outros clientes MCP com Siemens TIA Portal V21 via API Openness. Permite automação de programação, edição de projetos e gerenciamento de dispositivos em ambientes de automação industrial através de interface padronizada.
Instalação
npx convez-ai spatenimgarten/mcp-server1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automação de tarefas repetitivas em projetos TIA Portal
- Análise e geração de código de automação industrial
- Integração de Claude em workflows de engenharia de controle
Veredito

MCP Server especializado e bem arquitetado para domínio industrial muito específico. Requer conhecimento profundo de TIA Portal e automação Siemens; suporta múltiplas sessões concorrentes via arquitetura primário/proxy robusta.
README
A tradução para o português deste README ainda está na fila.
TIA Portal MCP Server
KI-Integration für Siemens TIA Portal V21 via Model Context Protocol (MCP).
Verbindet Claude Code und andere MCP-Clients mit TIA Portal über die Openness API.
Voraussetzungen
| Komponente | Version |
|---|---|
| TIA Portal | V21 (getestet), V19/V20 teilweise kompatibel |
| Python | 3.12+ |
| Siemens.Engineering.dll | V21 PublicAPI (C:\Program Files\Siemens\Automation\Portal V21\PublicAPI\V21\net48) |
| MCP Client | Claude Code (Desktop App) |
Installation
C:\tia-mcp\mcp-server\
server.py ← MCP-Einstiegspunkt
tia.py ← Openness-Logik
README.md
TESTING.md
commit.bat ← Git-Hilfsskript (add + commit + push in einem Schritt)
export\ ← Exportpfad (wird automatisch angelegt)
import\ ← Importpfad für write_import_file
Commits — commit.bat staged tia.py, server.py, README.md und TESTING.md automatisch:
commit.bat "v1.x.y: kurze Beschreibung der Änderung"
Claude Code — Einstellungen → MCP Servers:
{
"mcpServers": {
"tia-portal": {
"command": "C:\\tia-mcp\\mcp-server\\.venv\\Scripts\\python.exe",
"args": ["C:\\tia-mcp\\mcp-server\\server.py"]
}
}
}
Architektur: Primär / Proxy
Ab v1.4.0 können mehrere Claude-Sessions gleichzeitig auf denselben TIA Portal MCP Server zugreifen:
- Erste Instanz (primär): Bindet Port 47823 als internen JSON-RPC-Server, hält die TIA Openness COM-Verbindung und führt alle Tool-Calls aus.
- Weitere Instanzen (proxy): Erkennen automatisch dass eine primäre Instanz läuft, verbinden sich via TCP und leiten alle MCP-Aufrufe durch.
COM-Zugriffe bleiben single-threaded und werden durch einen internen Lock serialisiert. Wird die primäre Instanz beendet, übernimmt beim nächsten Start automatisch die nächste Instanz die Rolle des Primärs.
Versionsabfrage
get_version
Gibt die laufenden Versionen von server.py und tia.py zurück, inklusive Changelog der letzten Änderungen. match: true wenn beide auf dem gleichen Stand sind.
{
"server": { "version": "1.0.0", "date": "2026-06-14", "file": "..." },
"tia": { "version": "1.2.0", "date": "2026-06-14", "changes": [...] },
"match": false
}
match: falseist normal wenntia.pyaktualisiert wurde ohneserver.pyanzupassen.
Workflow
open_portal / connect_portal
↓
attach_project / open_project
↓
[Tools aufrufen]
↓
save_project
↓
close_project
open_portal— Startet TIA Portal als neuen Prozess (kann >4 Minuten dauern, ggf. Timeout).connect_portal— Verbindet sich mit einem bereits laufenden TIA Portal.attach_project— Übernimmt das im Portal geöffnete Projekt.open_project— Öffnet ein Projekt per Pfad.
Tools — Übersicht
Session & Projekt
| Tool | Parameter | Beschreibung |
|---|---|---|
open_portal | mode (gui|headless) | TIA Portal starten |
connect_portal | — | Laufendes Portal verbinden |
attach_project | — | Geöffnetes Projekt übernehmen |
open_project | path | Projekt per Pfad öffnen |
save_project | — | Projekt speichern |
close_project | — | Projekt schließen |
close_portal | — | TIA Portal beenden |
get_session_status | — | Verbindungsstatus |
get_version | — | Server- und tia.py-Version + Changelog |
get_project_info | — | Projektname, Pfad, Geräteliste |
list_devices | — | Alle Geräte mit Typ (PLC / Advanced / Unified) |
restart_server | — | Primären MCP-Prozess sauber neu starten |
PLC
| Tool | Parameter | Beschreibung |
|---|---|---|
compile_plc | device_name | PLC kompilieren |
list_plc_blocks | device_name, [group] | Alle Bausteine auflisten (inkl. Untergruppen, opt. Gruppenfilter) |
list_plc_tag_tables | device_name | Alle Tag-Tabellen auflisten |
list_plc_tags | device_name, table_name | Tags einer Tabelle auflisten |
list_plc_udts | device_name | Alle UDTs/Strukturen auflisten |
get_plc_block_source | device_name, block_name | SCL-Quellcode lesen |
set_plc_block_source | device_name, block_name, scl_source | SCL-Quellcode schreiben¹ |
export_plc_block | device_name, block_name | Baustein als XML exportieren |
import_plc_block | device_name, file_path | Baustein aus XML importieren |
export_plc_tagtable | device_name, table_name | PLC-Tag-Tabelle exportieren |
import_plc_tagtable | device_name, file_path | PLC-Tag-Tabelle importieren |
get_plc_config | device_name | Alle CPU-Attribute auslesen (Zyklus, Startup, Netzwerk, OPC UA …) |
set_plc_config | device_name, settings | CPU-Attribute schreiben (schreibgeschützte werden übersprungen) |
export_plc_config | device_name, [output_path] | CPU-Konfiguration als Excel exportieren, gruppiert nach Kategorien |
¹ Nur einfache SCL-Anweisungen ohne Keywords/Kommentare. Für komplexen SCL: Export → XML bearbeiten → Import.
HMI: Lesen
| Tool | Parameter | Beschreibung |
|---|---|---|
list_hmi_screens | device_name | Alle Screens (Advanced + Unified) |
list_hmi_tags | device_name, [table_name] | HMI-Tags (optional gefiltert) |
list_hmi_alarms | device_name | Alarme (Unified: discrete + analog) |
list_hmi_connections | device_name | HMI-Verbindungen (Advanced + Unified)² |
list_hmi_cycles | device_name | Erfassungszyklen — Advanced: Name + Periode; Unified: V21-Limit |
list_hmi_scheduled_tasks | device_name | Geplante Tasks — Advanced + Unified: V21-Limit |
list_hmi_logs | device_name | Datenlogs auslesen (Unified) — Name, Segmentgröße, Speicher, Backup |
list_hmi_textlists | device_name | Textlisten (Advanced)³ |
² Nur nicht-integrierte Verbindungen zugänglich. Integrierte Verbindungen (TIA-Netzwerktopologie) sind in V21 nicht über die API erreichbar.
³ V21-Limitation Unified: TextLists nicht verfügbar.
HMI: Export & Import
| Tool | Parameter | Beschreibung |
|---|---|---|
export_hmi_screen | device_name, screen_name, output_path | Einzelnen Screen exportieren³ |
export_hmi_screens_all | device_name, [output_path] | Alle Screens exportieren³ |
import_hmi_screen | device_name, file_path | Screen importieren⁴ |
export_hmi_tags | device_name, [output_path] | Alle Tag-Tabellen exportieren |
export_hmi_tagtable | device_name, table_name, [output_path] | Einzelne Tag-Tabelle exportieren |
import_hmi_tagtable | device_name, file_path | Tag-Tabelle importieren |
import_hmi_tags | device_name, file_path | Alle HMI-Tags importieren |
export_hmi_alarms | device_name, [output_path] | Alarme exportieren² |
import_hmi_alarms | device_name, file_path | Alarme importieren² |
export_hmi_textlists | device_name, [output_path] | Textlisten exportieren² |
import_hmi_textlists | device_name, file_path | Textlisten importieren² |
export_hmi_scripts | device_name, [output_path] | Scripts exportieren |
import_hmi_scripts | device_name, file_path | Scripts importieren |
create_hmi_structure | device_name, structure | Ordnerstruktur anlegen (experimentell) |
HMI: Konfiguration (Advanced & Unified)
| Tool | Parameter | Beschreibung |
|---|---|---|
get_hmi_config | device_name | HMI-Gerätekonfiguration auslesen — Advanced und Unified (IP, Display, Runtime …); Unified zusätzlich mit RuntimeSettings |
set_hmi_config | device_name, settings | HMI-Gerätekonfiguration schreiben — Advanced und Unified; Unified schreibt auch RuntimeSettings-Keys |
export_hmi_config | device_name, [output_path] | Excel-Export: Advanced = 1 Sheet blau; Unified = Sheet Gerät (grün) + Sheet RuntimeSettings |
list_hmi_logs | device_name | Datenlogs auslesen (Unified) |
set_hmi_log | device_name, log_name, settings | Datenlog-Einstellungen schreiben — Name, SegmentMaxSize, LogMaxSize, StorageDevice, StorageFolder |
get_hmi_runtime_settings | device_name | Runtime-Einstellungen auslesen (nur Unified) |
set_hmi_runtime_settings | device_name, settings | Runtime-Einstellungen schreiben (nur Unified) |
export_hmi_runtime_settings | device_name, [output_path] | Runtime-Einstellungen als Excel (nur Unified) |
Hardware & Projekt
| Tool | Parameter | Beschreibung |
|---|---|---|
export_hw_config | [output_path] | Hardware-Konfiguration aller Geräte als Excel (Station, Komponente, Bestellnr., Slot, IP) |
³ Advanced: direkte API. Unified: V21-Limitation — Screens in binären DB-Dateien, kein Openness-Export möglich.
⁴ Advanced: existierender Screen wird automatisch gelöscht, dann importiert. Unified: V21-Limitation.
Bibliotheken
| Tool | Parameter | Beschreibung |
|---|---|---|
list_libraries | — | Projekt- + Globale Bibliotheken |
list_library_types | library_name | Typen einer Bibliothek |
get_library_type_versions | library_name, type_name | Versionen eines Typs |
list_master_copies | library_name | Master Copies |
Hilfsfunktionen
| Tool | Parameter | Beschreibung |
|---|---|---|
execute_openness | code, [mode] | Python-Code direkt gegen TIA Openness ausführen |
write_import_file | filename, content | Datei in export/import/ schreiben |
read_export_file | file_path | Exportierte Datei lesen |
get_standard_template | — | Vorlage für Standardstruktur (PLC + HMI + Bibliothek) |
HMI-Funktionsumfang nach Bereich
Bereich-Referenz basierend auf TIA Portal Projektbaum. ✅ implementiert · ⚠️ eingeschränkt · ❌ V21-Limit · — fehlt noch
| TIA-Bereich | Tool | Advanced | Unified | Anmerkung |
|---|---|---|---|---|
| Runtime settings | get/set/export_hmi_config | ✅ | ✅ | Unified zusätzlich mit RuntimeSettings-Sheet |
| Screens | list/export/import_hmi_screen(s) | ✅ | ⚠️ | Unified: nur list; Export/Import V21-Limit |
| Screen management | — | ❌ | ❌ | V21-Limit |
| HMI tags | list/export/import_hmi_tags | ✅ | ✅ | |
| Connections | list_hmi_connections | ⚠️ | ✅ | Nur nicht-integrierte; integrierte V21-Limit |
| HMI alarms | list_hmi_alarms | ❌ | ✅ | Advanced: immer [] (V21-Limit) |
| Recipes | — | ❌ | ❌ | V21-Limit |
| Historical data / Logs | list_hmi_logs, set_hmi_log | ❌ | ✅ | Advanced: DataLogs nicht zugänglich |
| Scripts | export/import_hmi_scripts | ✅ | ✅ | Advanced: VBScript · Unified: JS/YML |
| Scheduled tasks | list_hmi_scheduled_tasks | ❌ | ❌ | V21-Limit — ScheduledTaskFolder nicht zugänglich |
| Cycles | list_hmi_cycles | ✅ | ❌ | Advanced: Name, Periode, system-Flag · Unified: V21-Limit |
| Reporting / Reports | — | ❌ | ❌ | V21-Limit |
| Parameter set types | — | — | ❌ | V21-Limit Unified |
| Collaboration data | — | — | ❌ | V21-Limit Unified |
| Text and graphic lists | list/export/import_hmi_textlists | ✅ | ⚠️ | Unified: list ✅ (user+system), export/import nur user-Listen |
| User administration | — | ❌ | ❌ | V21-Limit |
❌-Bereiche sind Einschränkungen der TIA Portal Openness API V21, nicht des MCP-Servers.
Funktionsumfang — Detailanalyse
PLC
| Aufgabe | Tool | Status |
|---|---|---|
| Geräte auflisten | get_project_info, list_devices | ✅ |
| Bausteine auflisten | list_plc_blocks | ✅ inkl. Untergruppen + Gruppenfilter |
| Tag-Tabellen auflisten | list_plc_tag_tables | ✅ inkl. Untergruppen |
| Tags auflisten | list_plc_tags | ✅ mit Typ, Adresse, Kommentar |
| UDTs auflisten | list_plc_udts | ✅ inkl. Untergruppen |
| Bausteine lesen (SCL) | get_plc_block_source | ✅ |
| Bausteine exportieren (XML) | export_plc_block | ✅ |
| Bausteine importieren | import_plc_block | ✅ |
| SCL schreiben | set_plc_block_source | ⚠️ nur einfache Anweisungen |
| Kompilieren | compile_plc | ✅ |
| Tag-Tabellen exportieren | export_plc_tagtable | ✅ |
| Tag-Tabellen importieren | import_plc_tagtable | ✅ |
| CPU-Konfiguration lesen | get_plc_config | ✅ alle DeviceItem-Attribute |
| CPU-Konfiguration schreiben | set_plc_config | ✅ skalare Attribute |
| CPU-Konfiguration exportieren | export_plc_config | ✅ Excel, gruppiert |
| DB-Inhalte lesen | — | ❌ fehlt |
| Bausteine löschen | — | ❌ fehlt |
WinCC Advanced (HmiTarget — z.B. KP/TP Comfort)
| Aufgabe | Tool | Status |
|---|---|---|
| Screens auflisten | list_hmi_screens | ✅ |
| Screen exportieren | export_hmi_screen, export_hmi_screens_all | ✅ |
| Screen importieren | import_hmi_screen | ✅ |
| Tags auflisten | list_hmi_tags | ✅ |
| Tags exportieren | export_hmi_tags, export_hmi_tagtable | ✅ |
| Tags importieren | import_hmi_tags, import_hmi_tagtable | ✅ |
| Scripts exportieren | export_hmi_scripts | ✅ VBScript |
| Scripts importieren | import_hmi_scripts | ✅ VBScript |
| Gerätekonfiguration lesen | get_hmi_config | ✅ DeviceItem-Attribute |
| Gerätekonfiguration schreiben | set_hmi_config | ✅ skalare Attribute |
| Gerätekonfiguration exportieren | export_hmi_config | ✅ Excel |
| Verbindungen auflisten | list_hmi_connections | ⚠️ nur nicht-integrierte |
| Erfassungszyklen auflisten | list_hmi_cycles | ✅ Name, Periode, system-Flag |
| Textlisten auflisten | list_hmi_textlists | ✅ |
| Textlisten exportieren | export_hmi_textlists | ✅ XML |
| Textlisten importieren | import_hmi_textlists | ✅ XML (Override) |
| Alarme auflisten | list_hmi_alarms | ❌ V21-Limit |
| Datenlogs | list_hmi_logs | ❌ V21-Limit |
| Geplante Tasks | list_hmi_scheduled_tasks | ❌ V21-Limit |
| Rezepte | — | ❌ V21-Limit |
| Tags anlegen / löschen | — | ❌ fehlt |
WinCC Unified (HmiSoftware)
| Aufgabe | Tool | Status |
|---|---|---|
| Screens auflisten | list_hmi_screens | ✅ |
| Screen exportieren | export_hmi_screen, export_hmi_screens_all | ❌ V21-Limit |
| Screen importieren | import_hmi_screen | ❌ V21-Limit |
| Tags auflisten | list_hmi_tags | ✅ |
| Tags exportieren | export_hmi_tags, export_hmi_tagtable | ✅ |
| Tags importieren | import_hmi_tags, import_hmi_tagtable | ✅ |
| Alarme auflisten | list_hmi_alarms | ✅ |
| Scripts exportieren | export_hmi_scripts | ✅ JS/YML |
| Scripts importieren | import_hmi_scripts | ✅ |
| Gerätekonfiguration lesen | get_hmi_config | ✅ DeviceItem + RuntimeSettings |
| Gerätekonfiguration schreiben | set_hmi_config | ✅ DeviceItem + RuntimeSettings |
| Gerätekonfiguration exportieren | export_hmi_config | ✅ Excel, 2 Sheets |
| Verbindungen auflisten | list_hmi_connections | ✅ |
| Datenlogs auslesen | list_hmi_logs | ✅ Segment, Settings, Backup |
| Datenlog schreiben | set_hmi_log | ✅ Name, Segmentgröße, Speicher |
| Erfassungszyklen auflisten | list_hmi_cycles | ❌ V21-Limit |
| Geplante Tasks | list_hmi_scheduled_tasks | ❌ V21-Limit |
| Textlisten | list_hmi_textlists | ❌ V21-Limit |
| Tags anlegen / löschen | — | ❌ fehlt |
Bibliotheken
| Aufgabe | Tool | Status |
|---|---|---|
| Bibliotheken auflisten | list_libraries | ✅ |
| Typen auflisten | list_library_types | ✅ |
| Typ-Versionen | get_library_type_versions | ✅ |
| Master Copies auflisten | list_master_copies | ✅ |
| Typ exportieren | — | ❌ fehlt |
| Typ importieren / instanziieren | — | ❌ fehlt |
| Master Copy verwenden | — | ❌ fehlt |
| Globale Bibliothek laden | — | ❌ fehlt |
Roadmap — Fehlende Tools
Tools die noch nicht implementiert sind, nach Priorität:
| Prio | Tool | Bereich | Status |
|---|---|---|---|
list_plc_blocks | PLC | ✅ v1.3.0 | |
list_plc_tag_tables | PLC | ✅ v1.3.0 | |
list_plc_tags | PLC | ✅ v1.3.0 | |
list_plc_udts | PLC | ✅ v1.3.0 | |
| 🟠 MITTEL | export_plc_udt / import_plc_udt | PLC | UDTs zwischen Projekten transferieren |
| 🟠 MITTEL | create_hmi_tag | HMI | Tags programmatisch anlegen ohne XML-Umweg |
| 🟠 MITTEL | delete_hmi_tag | HMI | Tags löschen / bereinigen |
| 🟡 NIEDRIG | list_plc_block_groups | PLC | Ordnerstruktur der Bausteine (bereits in list_plc_blocks enthalten) |
| 🟡 NIEDRIG | export_library_type | Bibliothek | Bibliothekstypen sichern |
| 🟡 NIEDRIG | use_library_type | Bibliothek | Typ in Projekt instanziieren |
| 🟡 NIEDRIG | get_cross_references | PLC/HMI | Querverweise zwischen Tags und Bausteinen |
V21-Limitationen (Alarme, Textlisten, Unified Screens, Rezepte) können nicht durch neue Tools umgangen werden — das ist eine Einschränkung der TIA Openness API selbst, nicht des MCP-Servers.
Advanced vs. Unified — Unterschiede
| WinCC Advanced (HmiTarget) | WinCC Unified (HmiSoftware) | |
|---|---|---|
| Typ-Erkennung | Siemens.Engineering.Hmi.HmiTarget | Siemens.Engineering.HmiUnified.HmiSoftware |
| Screen-API | ScreenFolder.Folders → Screens | ScreenGroups → Screens |
| Tag-API | TagFolder.TagTables | TagTables direkt |
| Tag-Export | table.Export(FileInfo) → XML | table.Tags.Export(DirectoryInfo) → Ordner |
| Script-API | VBScriptFolder.VBScripts | Scripts Collection |
| Screen-Export | ✅ s.Export(FileInfo) | ❌ V21-Limitation |
| Alarm-API | Kein DiscreteAlarms-Export | Kein DiscreteAlarms-Export |
Bekannte Einschränkungen (V21)
open_portalkann auf manchen Systemen >4 Minuten dauern → Timeout. Workaround: TIA manuell starten, dannconnect_portal.project.Save()inexecute_openness— nicht unterstützt, disposed Projekt-Handle. Immersave_project-Tool verwenden.CreateFB()inexecute_openness— nur ProDiag. Neue Bausteine per XML-Import anlegen.- STA-Thread-Timeout: Hängende API-Aufrufe werden nach 60 Sekunden abgebrochen. Der Server bleibt verfügbar, Session-Handles werden zurückgesetzt →
connect_portal+attach_projecterneut aufrufen. - Unified Screen-Export — Screens sind in binären DB-Dateien eingebettet, kein Zugriff über Openness möglich.
Fehlerformat
Alle Fehler folgen diesem Schema:
{
"status": "error",
"code": "BLOCK_NOT_FOUND",
"message": "Baustein 'XYZ' nicht gefunden.",
"recoverable": true,
"details": {
"available": ["Main", "FC_MCP_Test"]
}
}
recoverable: true = Fehler durch andere Parameter behebbar. recoverable: false = Systemlimitation.
Changelog
| Version | Datum | Änderungen |
|---|---|---|
| 1.12.0 | 2026-06-16 | set_hmi_log — Unified DataLog-Einstellungen schreiben (Name, Segment, Storage) |
| 1.11.0 | 2026-06-16 | list_hmi_logs — Unified DataLogs mit Segment, Settings, Backup |
| 1.10.0 | 2026-06-16 | list_hmi_connections — nicht-integrierte HMI-Verbindungen; list_hmi_textlists Fix (sucht alle Items) |
| 1.9.0 | 2026-06-16 | list_hmi_cycles, list_hmi_scheduled_tasks — Erfassungszyklen (Advanced ✅, Unified ❌) und geplante Tasks (V21-Limit) |
| 1.8.0 | 2026-06-16 | get_hmi_config, set_hmi_config, export_hmi_config — HMI-DeviceItem-Attribute für Advanced und Unified; Unified-Excel mit RuntimeSettings-Sheet |
| 1.7.0 | 2026-06-16 | get_plc_config, set_plc_config, export_plc_config — CPU-Konfigurationsattribute lesen, schreiben und als Excel exportieren |
| 1.6.0 | 2026-06-16 | get_hmi_runtime_settings, set_hmi_runtime_settings, export_hmi_runtime_settings — WinCC Unified Runtime-Einstellungen |
| 1.5.0 | 2026-06-16 | export_hw_config — Hardware-Konfiguration aller Geräte als Excel exportieren |
| 1.4.0 | 2026-06-16 | Primär/Proxy-Architektur: mehrere Sessions teilen eine TIA-Verbindung; restart_server-Tool; BUG-15 Fix list_plc_tags comment-Feld |
| 1.3.0 | 2026-06-15 | list_plc_blocks, list_plc_tag_tables, list_plc_tags, list_plc_udts — PLC vollständig lesbar |
| 1.2.0 | 2026-06-14 | BUG-11–14 gefixt: rekursive Screen-Suche, Unified-Typ-Erkennung, HmiTarget-API-Support, import_hmi_screen mit XML-basiertem Delete-vor-Import |
| 1.1.0 | 2026-06-14 | STA-Timeout + Auto-Restart, export_hmi_tags Unified-Workaround, VBScriptFolder-Support, import_hmi_scripts Advanced/Unified |
| 1.0.0 | 2026-06-14 | Erster stabiler Release: 10 Bugs gefixt, Advanced/Unified-Weiche, alle HMI-Tools, PLC-Tools vollständig |