TIA Portal Docs — Siemens PLC programming docs over MCP

TiaLink — TIA Portal MCP 网关

TiaLink 是由 汇智网 (hubwiz.com) 提供的 TIA Portal MCP 网关。 它让任何支持 MCP 的 AI Agent 都能直接操作 Siemens TIA Portal 项目。

📄 产品页面：https://tia.hubwiz.com/tia-link

---

功能介绍

TiaLink 将 Siemens TIA Portal 的功能封装为 MCP 工具，让 AI Agent 能够：

• 配置硬件和网络 — 添加设备和模块、分配 IP 地址、创建子网和 IO 系统
• 处理程序和数据 — 创建 FB / FC / DB / UDT 块、编写 SCL、导入 SimaticML（包括 LAD）块
• 构建 — 编译、保存、导出和归档项目
• 仿真和验证 — 下载到 S7-PLCSIM Advanced、读写变量、运行测试场景
• 读取结果 — 读取项目模型、块接口和硬件树以进行验证

简而言之：Agent 不会只在聊天窗口中给出代码片段，而是会操作真实的 TIA Portal 项目并读取操作结果。

---

工作原理

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

• 协议：MCP（Model Context Protocol），Streamable HTTP，端点 /mcp
• 底层技术：Siemens TIA Portal Openness
• 不依赖特定 Agent：TiaLink 不绑定任何特定模型或供应商。任何支持 Streamable HTTP 且能够发送 Bearer 标头的 MCP 客户端都可以连接。

---

快速入门

1. 检查计算机环境 — Windows、已授权的 TIA Portal V19 或 V20（暂不支持 V21），以及属于本地 Siemens TIA Openness 组的 Windows 账户。完整检查清单见 install.md。
2. 购买并下载 — TiaLink 是付费软件：中国地区价格为 ¥99/月或 ¥999/年。请在产品页面购买；微信支付完成后会立即显示下载链接和安装步骤。请保留订单号——申请许可证时需要提供。
3. 将 MCP 客户端连接到网关 — Claude Code、Cursor、VS Code 和 Claude Desktop 的现成配置位于 examples/。
4. 验证 — 列出工具、读取一个临时项目，然后创建一个块并检查编译结果。如果第三步失败，请参阅 install.md 中的故障排除表。

如果客户端只支持 stdio

TiaLink 提供 Streamable HTTP 服务。大多数客户端都能直接处理，但某些 桌面宿主和一键安装包只能启动 stdio 服务。为此，本仓库提供了一个小型适配器，即 server/index.js — 它在 stdio 和网关之间转发 JSON-RPC，不提供任何其他功能。

⚠️ 适配器不是产品本身。 它需要已运行且获得许可的 TiaLink 网关。 如果没有网关，它会按设计在第一个请求时失败。

# 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

路径	内容
npx tialink-mcp	stdio ↔ HTTP 适配器（npm、无依赖、Node ≥ 18）
manifest.json + .mcpb	一键式桌面安装包 — npx @anthropic-ai/mcpb pack .
Dockerfile	容器中的同一适配器，适用于 Linux CI 和沙盒 Agent

通过环境变量进行配置：TIALINK_URL（默认值为 http://127.0.0.1:8080/mcp）、TIALINK_TOKEN、TIALINK_TIMEOUT_MS（默认值 600000 — 编译和下载调用会有意设置得较慢）。

部署

• TiaLink 运行在 与 TIA Portal 相同的 Windows 计算机上（Openness 只能在安装了 TIA Portal 的计算机上运行）。
• MCP 客户端可以在另一台计算机上运行，并通过局域网连接 — 例如，http://<gateway-host>:8080/mcp。
• 项目数据不会离开本地网络。 适用于离线和本地部署环境。
• 建议：配置 API 令牌；MCP 客户端会将其作为 Bearer 标头发送。

---

支持的客户端

任何支持 Streamable HTTP 且可以发送 Bearer 标头的 MCP 客户端，例如：

• Claude Code
• Cursor
• VS Code

TiaLink 不绑定特定厂商——同一网关可与不同的 Agent 配合使用（包括腾讯 WorkBuddy 和其他 MCP 客户端）。

---

MCP 配置示例

{
  "mcpServers": {
    "tialink": {
      "type": "http",
      "url": "http://192.168.1.78:8080/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_TOKEN>"
      }
    }
  }
}

将 192.168.1.78 替换为运行 TiaLink 的计算机的 IP 地址或主机名，并将 <YOUR_API_TOKEN> 替换为你配置的令牌。特定客户端的配置（包括从环境变量而非文件中读取令牌的配置）位于 examples/。

---

TIA Forge 套件中的相关工具

TiaLink 是由汇智网打造的 TIA Portal 工程 Agent 套件 TIA Forge 的一部分：

• reverse-docs — 对现有 PLC 项目进行逆向工程文档编制
• lad2scl / txt2scl / txt2lad — LAD / SCL / 文本转换
• block-sim — 块级仿真

还可以在这里找到我们

• Awesome PLC AI — 汇智网维护的精选 PLC 工程 AI 工具、Agent 和 MCP 桥接工具列表，涵盖 Siemens TIA Portal、CODESYS、TwinCAT、Studio 5000、GX Works。TiaLink 与其他替代方案一同列于其中，并附有披露说明。

---

常见问题

TiaLink 是什么？ TiaLink 是汇智网（hubwiz.com）打造的 TIA Portal MCP 网关。它可让任何 AI Agent 通过 MCP 协议操作 Siemens TIA Portal 项目。

TiaLink 需要访问互联网吗？ 不需要。TiaLink 与 TIA Portal 运行在同一台计算机上，所有操作都在本地进行，项目数据也保留在本地。

MCP 网关必须与 TIA Portal 安装在同一台计算机上吗？ 网关本身必须运行在与 TIA Portal 相同的计算机上（Openness 有此要求）。但 MCP 客户端可以运行在其他计算机上，并通过局域网连接。

TiaLink 是否绑定某个 AI 厂商？ 不绑定。TiaLink 不限定 Agent——任何支持带有 Bearer 标头的 Streamable HTTP 的 MCP 客户端都可以使用它。

AI 生成的 PLC 代码可以直接使用吗？ AI 负责可验证的软件部分，但安全功能必须通过硬件实现（安全继电器 / 安全 PLC），硬联锁必须采用气动或电气方式实现，时间和传感器调试必须在真实机器上进行。TiaLink 不会替代安全责任。

费用是多少？ ¥99/月或 ¥999/年（中国；年付可节省 ¥189）。多席位、浮动许可和隔离网络企业部署需单独报价——请发送邮件至 [email protected]。

如何购买并获取许可证？ 在产品页面购买：完成微信支付后，页面会立即显示下载链接和设置步骤——无需账户或填写表单。以普通用户身份安装 TiaLink，打开 http://localhost:8080/，然后将机器码和生成的 .tlreq 请求文件发送至 [email protected]。绑定到该计算机的 .lic 许可证会为这台计算机签发，并可完全离线使用。

---

链接

• 产品页面 / 购买：https://tia.hubwiz.com/tia-link（微信支付；付款后显示下载链接）
• 发布方：汇智网 — https://www.hubwiz.com/

---

许可证

• 本仓库中的文档采用 CC BY 4.0 许可——详见 LICENSE。
• TiaLink 软件本身（MCP 网关 / 服务）为商业软件，不受该许可证约束。版权所有。
• server/ 中的 stdio 桥接程序，以及其 package.json、manifest.json 和 Dockerfile，采用 MIT 许可证——详见 LICENSE-BRIDGE。它是一个轻量级传输适配器：你可以派生、集成并将其打包到自己的 Agent 工具中。运行时仍需使用获得许可的 TiaLink 网关。