TiaLink

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 与其他替代方案一同列于其中，并附有披露说明。
• SkillHub — 将网关打包为 Agent Skill（skillhub install tialink-tia-portal）：其中包含前置条件、连接代码片段、首次会话验证和安全规则，内容面向读取它的 Agent，而非快速浏览 README 的人类读者。同一发布者还提供三个配套 Skill：LadDoc → SimaticML、云端仿真和 TIA Portal 文档搜索。

---

常见问题

什么是 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 网关。