convez.ai
MCP ServerAutomaçãoAvançado
spatenimgarten

MCP Server TIA Portal

spatenimgarten/mcp-server

Integração de IA com Siemens TIA Portal para automação de engenharia

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor 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-server

1 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

Estrelas
1
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
1

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

KomponenteVersion
TIA PortalV21 (getestet), V19/V20 teilweise kompatibel
Python3.12+
Siemens.Engineering.dllV21 PublicAPI (C:\Program Files\Siemens\Automation\Portal V21\PublicAPI\V21\net48)
MCP ClientClaude 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: false ist normal wenn tia.py aktualisiert wurde ohne server.py anzupassen.


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

ToolParameterBeschreibung
open_portalmode (gui|headless)TIA Portal starten
connect_portal—Laufendes Portal verbinden
attach_project—Geöffnetes Projekt übernehmen
open_projectpathProjekt 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

ToolParameterBeschreibung
compile_plcdevice_namePLC kompilieren
list_plc_blocksdevice_name, [group]Alle Bausteine auflisten (inkl. Untergruppen, opt. Gruppenfilter)
list_plc_tag_tablesdevice_nameAlle Tag-Tabellen auflisten
list_plc_tagsdevice_name, table_nameTags einer Tabelle auflisten
list_plc_udtsdevice_nameAlle UDTs/Strukturen auflisten
get_plc_block_sourcedevice_name, block_nameSCL-Quellcode lesen
set_plc_block_sourcedevice_name, block_name, scl_sourceSCL-Quellcode schreiben¹
export_plc_blockdevice_name, block_nameBaustein als XML exportieren
import_plc_blockdevice_name, file_pathBaustein aus XML importieren
export_plc_tagtabledevice_name, table_namePLC-Tag-Tabelle exportieren
import_plc_tagtabledevice_name, file_pathPLC-Tag-Tabelle importieren
get_plc_configdevice_nameAlle CPU-Attribute auslesen (Zyklus, Startup, Netzwerk, OPC UA …)
set_plc_configdevice_name, settingsCPU-Attribute schreiben (schreibgeschützte werden übersprungen)
export_plc_configdevice_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

ToolParameterBeschreibung
list_hmi_screensdevice_nameAlle Screens (Advanced + Unified)
list_hmi_tagsdevice_name, [table_name]HMI-Tags (optional gefiltert)
list_hmi_alarmsdevice_nameAlarme (Unified: discrete + analog)
list_hmi_connectionsdevice_nameHMI-Verbindungen (Advanced + Unified)²
list_hmi_cyclesdevice_nameErfassungszyklen — Advanced: Name + Periode; Unified: V21-Limit
list_hmi_scheduled_tasksdevice_nameGeplante Tasks — Advanced + Unified: V21-Limit
list_hmi_logsdevice_nameDatenlogs auslesen (Unified) — Name, Segmentgröße, Speicher, Backup
list_hmi_textlistsdevice_nameTextlisten (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

ToolParameterBeschreibung
export_hmi_screendevice_name, screen_name, output_pathEinzelnen Screen exportieren³
export_hmi_screens_alldevice_name, [output_path]Alle Screens exportieren³
import_hmi_screendevice_name, file_pathScreen importieren⁴
export_hmi_tagsdevice_name, [output_path]Alle Tag-Tabellen exportieren
export_hmi_tagtabledevice_name, table_name, [output_path]Einzelne Tag-Tabelle exportieren
import_hmi_tagtabledevice_name, file_pathTag-Tabelle importieren
import_hmi_tagsdevice_name, file_pathAlle HMI-Tags importieren
export_hmi_alarmsdevice_name, [output_path]Alarme exportieren²
import_hmi_alarmsdevice_name, file_pathAlarme importieren²
export_hmi_textlistsdevice_name, [output_path]Textlisten exportieren²
import_hmi_textlistsdevice_name, file_pathTextlisten importieren²
export_hmi_scriptsdevice_name, [output_path]Scripts exportieren
import_hmi_scriptsdevice_name, file_pathScripts importieren
create_hmi_structuredevice_name, structureOrdnerstruktur anlegen (experimentell)

HMI: Konfiguration (Advanced & Unified)

ToolParameterBeschreibung
get_hmi_configdevice_nameHMI-Gerätekonfiguration auslesen — Advanced und Unified (IP, Display, Runtime …); Unified zusätzlich mit RuntimeSettings
set_hmi_configdevice_name, settingsHMI-Gerätekonfiguration schreiben — Advanced und Unified; Unified schreibt auch RuntimeSettings-Keys
export_hmi_configdevice_name, [output_path]Excel-Export: Advanced = 1 Sheet blau; Unified = Sheet Gerät (grün) + Sheet RuntimeSettings
list_hmi_logsdevice_nameDatenlogs auslesen (Unified)
set_hmi_logdevice_name, log_name, settingsDatenlog-Einstellungen schreiben — Name, SegmentMaxSize, LogMaxSize, StorageDevice, StorageFolder
get_hmi_runtime_settingsdevice_nameRuntime-Einstellungen auslesen (nur Unified)
set_hmi_runtime_settingsdevice_name, settingsRuntime-Einstellungen schreiben (nur Unified)
export_hmi_runtime_settingsdevice_name, [output_path]Runtime-Einstellungen als Excel (nur Unified)

Hardware & Projekt

ToolParameterBeschreibung
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

ToolParameterBeschreibung
list_libraries—Projekt- + Globale Bibliotheken
list_library_typeslibrary_nameTypen einer Bibliothek
get_library_type_versionslibrary_name, type_nameVersionen eines Typs
list_master_copieslibrary_nameMaster Copies

Hilfsfunktionen

ToolParameterBeschreibung
execute_opennesscode, [mode]Python-Code direkt gegen TIA Openness ausführen
write_import_filefilename, contentDatei in export/import/ schreiben
read_export_filefile_pathExportierte 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-BereichToolAdvancedUnifiedAnmerkung
Runtime settingsget/set/export_hmi_config✅✅Unified zusätzlich mit RuntimeSettings-Sheet
Screenslist/export/import_hmi_screen(s)✅⚠️Unified: nur list; Export/Import V21-Limit
Screen management—❌❌V21-Limit
HMI tagslist/export/import_hmi_tags✅✅
Connectionslist_hmi_connections⚠️✅Nur nicht-integrierte; integrierte V21-Limit
HMI alarmslist_hmi_alarms❌✅Advanced: immer [] (V21-Limit)
Recipes—❌❌V21-Limit
Historical data / Logslist_hmi_logs, set_hmi_log❌✅Advanced: DataLogs nicht zugänglich
Scriptsexport/import_hmi_scripts✅✅Advanced: VBScript · Unified: JS/YML
Scheduled taskslist_hmi_scheduled_tasks❌❌V21-Limit — ScheduledTaskFolder nicht zugänglich
Cycleslist_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 listslist/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

AufgabeToolStatus
Geräte auflistenget_project_info, list_devices✅
Bausteine auflistenlist_plc_blocks✅ inkl. Untergruppen + Gruppenfilter
Tag-Tabellen auflistenlist_plc_tag_tables✅ inkl. Untergruppen
Tags auflistenlist_plc_tags✅ mit Typ, Adresse, Kommentar
UDTs auflistenlist_plc_udts✅ inkl. Untergruppen
Bausteine lesen (SCL)get_plc_block_source✅
Bausteine exportieren (XML)export_plc_block✅
Bausteine importierenimport_plc_block✅
SCL schreibenset_plc_block_source⚠️ nur einfache Anweisungen
Kompilierencompile_plc✅
Tag-Tabellen exportierenexport_plc_tagtable✅
Tag-Tabellen importierenimport_plc_tagtable✅
CPU-Konfiguration lesenget_plc_config✅ alle DeviceItem-Attribute
CPU-Konfiguration schreibenset_plc_config✅ skalare Attribute
CPU-Konfiguration exportierenexport_plc_config✅ Excel, gruppiert
DB-Inhalte lesen—❌ fehlt
Bausteine löschen—❌ fehlt

WinCC Advanced (HmiTarget — z.B. KP/TP Comfort)

AufgabeToolStatus
Screens auflistenlist_hmi_screens✅
Screen exportierenexport_hmi_screen, export_hmi_screens_all✅
Screen importierenimport_hmi_screen✅
Tags auflistenlist_hmi_tags✅
Tags exportierenexport_hmi_tags, export_hmi_tagtable✅
Tags importierenimport_hmi_tags, import_hmi_tagtable✅
Scripts exportierenexport_hmi_scripts✅ VBScript
Scripts importierenimport_hmi_scripts✅ VBScript
Gerätekonfiguration lesenget_hmi_config✅ DeviceItem-Attribute
Gerätekonfiguration schreibenset_hmi_config✅ skalare Attribute
Gerätekonfiguration exportierenexport_hmi_config✅ Excel
Verbindungen auflistenlist_hmi_connections⚠️ nur nicht-integrierte
Erfassungszyklen auflistenlist_hmi_cycles✅ Name, Periode, system-Flag
Textlisten auflistenlist_hmi_textlists✅
Textlisten exportierenexport_hmi_textlists✅ XML
Textlisten importierenimport_hmi_textlists✅ XML (Override)
Alarme auflistenlist_hmi_alarms❌ V21-Limit
Datenlogslist_hmi_logs❌ V21-Limit
Geplante Taskslist_hmi_scheduled_tasks❌ V21-Limit
Rezepte—❌ V21-Limit
Tags anlegen / löschen—❌ fehlt

WinCC Unified (HmiSoftware)

AufgabeToolStatus
Screens auflistenlist_hmi_screens✅
Screen exportierenexport_hmi_screen, export_hmi_screens_all❌ V21-Limit
Screen importierenimport_hmi_screen❌ V21-Limit
Tags auflistenlist_hmi_tags✅
Tags exportierenexport_hmi_tags, export_hmi_tagtable✅
Tags importierenimport_hmi_tags, import_hmi_tagtable✅
Alarme auflistenlist_hmi_alarms✅
Scripts exportierenexport_hmi_scripts✅ JS/YML
Scripts importierenimport_hmi_scripts✅
Gerätekonfiguration lesenget_hmi_config✅ DeviceItem + RuntimeSettings
Gerätekonfiguration schreibenset_hmi_config✅ DeviceItem + RuntimeSettings
Gerätekonfiguration exportierenexport_hmi_config✅ Excel, 2 Sheets
Verbindungen auflistenlist_hmi_connections✅
Datenlogs auslesenlist_hmi_logs✅ Segment, Settings, Backup
Datenlog schreibenset_hmi_log✅ Name, Segmentgröße, Speicher
Erfassungszyklen auflistenlist_hmi_cycles❌ V21-Limit
Geplante Taskslist_hmi_scheduled_tasks❌ V21-Limit
Textlistenlist_hmi_textlists❌ V21-Limit
Tags anlegen / löschen—❌ fehlt

Bibliotheken

AufgabeToolStatus
Bibliotheken auflistenlist_libraries✅
Typen auflistenlist_library_types✅
Typ-Versionenget_library_type_versions✅
Master Copies auflistenlist_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:

PrioToolBereichStatus
🔴 HOCHlist_plc_blocksPLC✅ v1.3.0
🔴 HOCHlist_plc_tag_tablesPLC✅ v1.3.0
🔴 HOCHlist_plc_tagsPLC✅ v1.3.0
🔴 HOCHlist_plc_udtsPLC✅ v1.3.0
🟠 MITTELexport_plc_udt / import_plc_udtPLCUDTs zwischen Projekten transferieren
🟠 MITTELcreate_hmi_tagHMITags programmatisch anlegen ohne XML-Umweg
🟠 MITTELdelete_hmi_tagHMITags löschen / bereinigen
🟡 NIEDRIGlist_plc_block_groupsPLCOrdnerstruktur der Bausteine (bereits in list_plc_blocks enthalten)
🟡 NIEDRIGexport_library_typeBibliothekBibliothekstypen sichern
🟡 NIEDRIGuse_library_typeBibliothekTyp in Projekt instanziieren
🟡 NIEDRIGget_cross_referencesPLC/HMIQuerverweise 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-ErkennungSiemens.Engineering.Hmi.HmiTargetSiemens.Engineering.HmiUnified.HmiSoftware
Screen-APIScreenFolder.Folders → ScreensScreenGroups → Screens
Tag-APITagFolder.TagTablesTagTables direkt
Tag-Exporttable.Export(FileInfo) → XMLtable.Tags.Export(DirectoryInfo) → Ordner
Script-APIVBScriptFolder.VBScriptsScripts Collection
Screen-Export✅ s.Export(FileInfo)❌ V21-Limitation
Alarm-APIKein DiscreteAlarms-ExportKein DiscreteAlarms-Export

Bekannte Einschränkungen (V21)

  • open_portal kann auf manchen Systemen >4 Minuten dauern → Timeout. Workaround: TIA manuell starten, dann connect_portal.
  • project.Save() in execute_openness — nicht unterstützt, disposed Projekt-Handle. Immer save_project-Tool verwenden.
  • CreateFB() in execute_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_project erneut 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

VersionDatumÄnderungen
1.12.02026-06-16set_hmi_log — Unified DataLog-Einstellungen schreiben (Name, Segment, Storage)
1.11.02026-06-16list_hmi_logs — Unified DataLogs mit Segment, Settings, Backup
1.10.02026-06-16list_hmi_connections — nicht-integrierte HMI-Verbindungen; list_hmi_textlists Fix (sucht alle Items)
1.9.02026-06-16list_hmi_cycles, list_hmi_scheduled_tasks — Erfassungszyklen (Advanced ✅, Unified ❌) und geplante Tasks (V21-Limit)
1.8.02026-06-16get_hmi_config, set_hmi_config, export_hmi_config — HMI-DeviceItem-Attribute für Advanced und Unified; Unified-Excel mit RuntimeSettings-Sheet
1.7.02026-06-16get_plc_config, set_plc_config, export_plc_config — CPU-Konfigurationsattribute lesen, schreiben und als Excel exportieren
1.6.02026-06-16get_hmi_runtime_settings, set_hmi_runtime_settings, export_hmi_runtime_settings — WinCC Unified Runtime-Einstellungen
1.5.02026-06-16export_hw_config — Hardware-Konfiguration aller Geräte als Excel exportieren
1.4.02026-06-16Primär/Proxy-Architektur: mehrere Sessions teilen eine TIA-Verbindung; restart_server-Tool; BUG-15 Fix list_plc_tags comment-Feld
1.3.02026-06-15list_plc_blocks, list_plc_tag_tables, list_plc_tags, list_plc_udts — PLC vollständig lesbar
1.2.02026-06-14BUG-11–14 gefixt: rekursive Screen-Suche, Unified-Typ-Erkennung, HmiTarget-API-Support, import_hmi_screen mit XML-basiertem Delete-vor-Import
1.1.02026-06-14STA-Timeout + Auto-Restart, export_hmi_tags Unified-Workaround, VBScriptFolder-Support, import_hmi_scripts Advanced/Unified
1.0.02026-06-14Erster stabiler Release: 10 Bugs gefixt, Advanced/Unified-Weiche, alle HMI-Tools, PLC-Tools vollständig
Ver o original no GitHub

Bom para

Relacionados