Tia-Portal

This MCP server provides a set of actions to interact with a TIA Portal project via TIA Portal Openness. It can open and close a TIA Portal project, list PLC devices, inspect and export program blocks (OB, FC, FB, DB), manage tag tables, retrieve and export hardware configuration, and export or inspect OPC UA server interfaces. Use the available actions to automate common tasks such as exporting blocks or tags for integration with other systems. The server exposes commands that map to TIA Portal operations, enabling scripted workflows and remote management of project data.

Prerequisites:

• A Windows environment with TIA Portal and TIA Portal Openness installed and licensed
• Node.js (recommended) or Docker if you prefer containerized execution
• Access to the TIA Portal project file(s) you intend to operate on

Option A: Node.js installation

1. Install Node.js from https://nodejs.org
2. Clone this MCP server repository: git clone <repository-url>
3. Navigate to the project directory: cd <repository-directory>
4. Install dependencies: npm install
5. Create or edit the configuration to point to your TIA Portal project and Openness settings (see mcp_config structure below). Ensure the server has access to the TIA Portal installation.
6. Start the MCP server: node server.js

Option B: Docker (containerized) installation

1. Ensure Docker is installed and running.
2. Build or pull a suitable image for the MCP server (replace with the actual image name if provided): docker pull tia-portal-mcp-server:latest
3. Run the container with appropriate volume mounts and environment variables to access your TIA Portal project: docker run -d --name tia-portal-mcp
   -p 8080:8080
   -v /path/to/your/projects:/projects
   -e TIA_PORTAL_PROJECT_PATH=/projects/yourProject.mwp
   tia-portal-mcp-server:latest
4. Verify the server is running and accessible at the configured port.

Configuring mcp_config

• The mcp_config section defines how to start the server and what environment variables to set. Update the paths and any required environment values (such as project path or openness settings) to match your environment.

Notes and tips:

• Only one TIA Portal project can be open at a time per server session. The server will enforce this limitation.
• The server runs in WithoutUserInterface mode; no GUI is shown to the user.
• OPC UA related operations require that OPC UA is configured in the TIA Portal project and that the PLC supports OPC UA.
• Be mindful of security: this server provides broad access to the TIA Portal project. Restrict network access, use authentication where possible, and consider sandboxing if exposing to untrusted networks.
• If you encounter “No project is open”, call Open Project before proceeding with other operations.
• For exact PLC names, use List PLCs to confirm availability and naming (case-sensitive).
• Ensure TIA Portal Openness assemblies are correctly referenced when exporting interfaces or information.
• Adjust environment variables to reflect your local project paths and Openess configuration as needed.