What is Tia Portal Mcp

The tia-portal-mcp is a Read-Only MCP Server designed for diagnosing connection issues with TIA Portal, providing tools for comprehensive diagnostics and testing.

Use cases

Use cases for tia-portal-mcp include diagnosing connection issues between Python applications and TIA Portal, testing TIA Portal projects, and ensuring proper MCP server configuration and status.

How to use

To use tia-portal-mcp, you can run diagnostics using the provided batch files or directly through Python scripts. Simply execute ‘run_mcp_diagnostics.bat’ or ‘python mcp_server_diagnostics.py’ to initiate the diagnostics.

Key features

Key features include connection testing to TIA Portal, opening TIA Portal projects, listing PLCs in projects, detailed error reporting, and logging system information for troubleshooting.

Where to use

tia-portal-mcp is primarily used in industrial automation and control systems where TIA Portal is implemented for programming and managing PLCs.

TIA Portal MCP Server

An MCP (Model Context Protocol) server that enables AI assistants to analyze Siemens TIA Portal industrial automation projects. Extract, search, and analyze PLC code, control logic, alarms, and safety systems.

Features

• Structured Export - Export TIA Portal projects into organized, searchable file structures
• Control Loop Analysis - Analyze PID controllers, trace loops, identify cascade/feedforward configurations
• Signal Flow Graphs - Build dependency graphs, trace signal paths, detect feedback loops
• Timer & Sequence Analysis - Analyze timers, trace step sequences, identify watchdogs
• Alarm Analysis - Trigger conditions, cause-effect matrices, flooding risk detection
• Safety Analysis - Trip logic, interlock conditions, SIF identification

Requirements

• Windows (TIA Portal requirement)
• Python 3.8+
• TIA Portal V13+ with Openness enabled
• NetworkX (for Logic Graph features)

Installation

# Clone repository
git clone https://github.com/your-org/tia-portal-mcp.git
cd tia-portal-mcp

# Set up virtual environment
python -m venv .venv
.venv\Scripts\activate  # Windows
# source .venv/bin/activate  # Linux/Mac

# Install dependencies
pip install -r requirements.txt

# Register TIA Portal DLLs (Windows only)
register_tia_dlls.bat

# Start server
python server_structured.py

Usage

1. Connect to TIA Portal

connect_to_tia()
open_project("C:/path/to/project.ap17")

2. Create Export

create_structured_export("my_analysis")

3. Analyze

# Build signal flow graph
build_logic_graph()

# Trace signal dependencies
analyze_signal_dependencies("PUMP_1.RUN")

# Analyze PID controller
analyze_pid_controller("FIC_101")

# Check safety interlocks
trace_interlock_conditions("V-101")

Available Tools (36)

Export Structure

export_name/
├── raw/                    # Raw XML by PLC
│   └── PANEL_1/
│       ├── INTERLOCKS.xml
│       └── ALARMS.xml
├── parsed/                 # Processed indices
│   ├── operands/
│   ├── equipment/
│   └── cross_references/
├── search/                 # Search-optimized text files
└── metadata.json

Compatible Clients

• Claude Code CLI
• Codex CLI
• Claude Agent SDK
• Any MCP-compatible AI client

Safety

All TIA Portal operations are read-only. The server cannot modify projects.

Documentation

• ROADMAP.md - Development status and future plans
• MCP_TOOLS.md - Detailed tool reference
• TROUBLESHOOTING.md - Common issues

License

MIT License - see LICENSE