Skip to main content
Glama
omirko00

OpenTIA-MCP

by omirko00
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

OpenTIA-MCP

An MCP (Model Context Protocol) server that lets AI agents interact with Siemens TIA Portal via its Openness API.

Requirements

  • Windows (TIA Portal is Windows-only)

  • Python 3.11+

  • TIA Portal V17–V20 with Openness API installed (V20 is what this repo is verified against)

  • pip (Python package installer)

  • For simulation and automated downloads: S7-PLCSIM Advanced (verified with 7.0)

Related MCP server: T-IA Connect (Siemens TIA Portal)

Installation

# Create a virtual environment (recommended)
python -m venv .venv
.venv\Scripts\activate

# Install the package in editable mode
pip install -e .

Configuration

Copy or create an opentia.toml file (see opentia.toml for the template). The server searches for it in this order:

  1. Path specified by the OPENTIA_CONFIG environment variable

  2. ./opentia.toml in the current working directory

  3. %APPDATA%\opentia-mcp\opentia.toml

Usage

# Start the MCP server
python -m opentia_mcp

Or use the installed entry point:

opentia-mcp

Tools

Tool

Purpose

tia_connect / tia_disconnect

Attach to a running Portal (use process_id when several run) or spawn one

tia_project_open / tia_project_close / tia_project_save / tia_project_info / tia_project_archive

Project lifecycle (Multiuser local sessions are handled: saving goes through LocalSessions[i].Save())

tia_block_list / tia_block_read_scl / tia_block_write_scl

Block inventory and SCL round-trip

tia_fb_create / tia_fc_create

Create blocks from SCL (optionally into a block group via group_path)

tia_simulation_start_plcsim / tia_simulation_status / tia_simulation_stop_plcsim

PLCSIM Advanced instance lifecycle (runtime API, not Openness)

tia_download_to_plc / tia_download_verify

Download to a virtual PLCSIM target and offline/online comparison

tia_documentation_generate

Project documentation

Project Structure

src/opentia_mcp/
├── __init__.py
├── __main__.py          # Entry point
├── server.py            # MCP server and tool registration
├── models.py            # Pydantic models
├── errors.py            # Exception hierarchy
├── config.py            # Configuration loading
├── logging.py           # Logging to stderr
└── tia/                 # Openness API abstraction layer
    ├── __init__.py
    ├── portal.py        # Connection lifecycle
    ├── project.py       # Project management
    ├── block.py         # PLC block CRUD
    ├── compilation.py   # Compilation
    ├── reference.py     # Cross-references
    ├── hmi.py           # HMI tags
    ├── watch.py         # Watch tables
    ├── diagnostic.py    # Diagnostics
    ├── simulation.py    # PLCSIM Advanced
    ├── download.py      # Download to PLC
    └── documentation.py # Documentation generation

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessSyncing

Resources

Related MCP Connectors

Related MCP Servers

  • WinCC Unified MCP XT

    mrwan84
    F
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that interfaces with SIEMENS WinCC Unified SCADA systems via GraphQL to manage real-time and historical tag data. It enables AI assistants to browse SCADA objects, read or write tag values, and perform alarm management tasks such as fetching, acknowledging, and resetting alarms.
    8
    -

  • tiacommander-mcp

    a4webdev
    F
    license
    Not graded
    quality
    A
    maintenance
    MCP server that connects AI assistants to Siemens TIA Portal via the Openness API. AI-assisted PLC programming, project management, hardware configuration, cross-reference analysis, and deployment. 19 tools, 230 actions.
    37
    -