TiaLink MCP server

TiaLink — TIA Portal MCP Gateway

TiaLink is a TIA Portal MCP gateway by 汇智网 (hubwiz.com). It lets any MCP-capable AI agent operate Siemens TIA Portal projects directly.

📄 Product page: https://tia.hubwiz.com/tia-link

What it does

TiaLink exposes Siemens TIA Portal capabilities as MCP tools, so an AI agent can:

• Configure hardware & networks — add devices and modules, assign IP addresses, create subnets and IO systems
• Work with programs & data — create FB / FC / DB / UDT blocks, write SCL, import SimaticML (including LAD) blocks
• Build — compile, save, export, and archive projects
• Simulate & verify — download to S7-PLCSIM Advanced, read/write variables, run test scenarios
• Read back — project model, block interfaces, and hardware tree for verification

In short: instead of getting a code snippet in a chat window, the agent operates a real TIA Portal project and reads the result back.

How it works

AI agent (MCP client)
        │  MCP (Streamable HTTP, endpoint /mcp)
        ▼
     TiaLink  ──►  Siemens TIA Portal Openness  ──►  TIA Portal project

• Protocol: MCP (Model Context Protocol), Streamable HTTP, endpoint /mcp
• Underlying: Siemens TIA Portal Openness
• Agent-agnostic: TiaLink does not bind to any specific model or vendor. Any MCP client that supports Streamable HTTP and can send a Bearer header can connect.

Getting started

1. Check the machine — Windows, a licensed TIA Portal V19 or V20 (V21 is not supported yet), and the Windows account in the local Siemens TIA Openness group. Full checklist: install.md.
2. Buy and download — TiaLink is paid software: ¥99/month or ¥999/year (China). Buy on the product page; the download link and the setup steps appear immediately after the WeChat Pay payment. Keep the order number — the licence request needs it.
3. Point your MCP client at the gateway — ready-made configurations for Claude Code, Cursor, VS Code and Claude Desktop are in examples/.
4. Verify — list the tools, read a scratch project, then create one block and require the compile result. If step three fails, see the troubleshooting table in install.md.

If your client only speaks stdio

TiaLink serves Streamable HTTP. Most clients handle that directly, but some desktop hosts and one-click bundles can only launch stdio servers. For those there is a small adapter in this repository, server/index.js — it forwards JSON-RPC between stdio and the gateway and adds no functionality of its own.

⚠️ The adapter is not the product. It needs a licensed TiaLink gateway

already running. Without one it fails on the first request — by design.

# Run the adapter against a local gateway
TIALINK_URL=http://127.0.0.1:8080/mcp npx tialink-mcp

# Pre-flight: is the gateway reachable, is the token right, which tools exist?
TIALINK_URL=http://192.168.1.78:8080/mcp TIALINK_TOKEN=... npx tialink-mcp --check

Configuration is by environment variable: TIALINKURL (default http://127.0.0.1:8080/mcp), TIALINKTOKEN, TIALINKTIMEOUTMS (default 600000 — compile and download calls are slow on purpose).

Deployment

Shortened. The full README is on GitHub.