mcpField
P
PLCWare - TIA Portal (tia)

PLCWare - TIA Portal (tia)

本地服务
plcware.io开发工具83 天前更新
代码仓库访问官网

关于 PLCWare - TIA Portal (tia)

PLCWare 通过 Openness 接口驱动 Siemens TIA Portal V21，并以本地 HTTP/JSON API 提供操作能力。它适用于需要创建或管理 PLC 项目、编译及受控下载的自动化工程师和应用；另有独立 MCP 客户端将 AI 工具连接到该 API。

主要功能

  1. 01创建设备与网络
  2. 02生成并导入 SCL/SimaticML
  3. 03管理块、类型和标签
  4. 04编译、下载并访问在线状态
  5. 05托盘 GUI 与无头命令行

适用场景

  1. 01创建 TIA Portal 设备和网络
  2. 02从 SCL 或 SimaticML 导入 PLC 块
  3. 03编译 PLC 项目并读取消息
  4. 04通过 AI 客户端驱动 TIA Portal 操作

MCP 相关

独立的 `@renanlido/tia-openness-mcp` 客户端连接运行中的 PLCWare HTTP API，并将其提供给 MCP 客户端。它不负责激活；许可证在运行 `serve` 的主机上配置。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "renanlido-tia-openness": {
      "command": "npx",
      "args": [
        "-y",
        "@renanlido/tia-openness-mcp"
      ],
      "env": {
        "TIA_API_BASE": "<TIA_API_BASE>",
        "TIA_MCP_MODE": "<TIA_MCP_MODE>"
      }
    }
  }
}
启动命令npx -y @renanlido/tia-openness-mcp
需要配置的环境变量
TIA_API_BASEBase URL of the PLCWare Desktop API (serve) that drives TIA Portal. Default http://localhost:5000; use http://<host>:5000 for a remote Windows host.
TIA_MCP_MODEUse full to register every tool or read-only to register only read tools.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@renanlido/tia-openness-mcp1.11.0

工具

158

收录的工具列表 · 更新于 3 天前

此工具无需参数。

详细介绍

PLCWare — 适用于 Siemens TIA Portal V21

Download MCP npm License

免费试用 30 天。 试用可自行开通，包含 Pro 范围，无需绑定银行卡： 开始 30 天试用 · plcware.io 提供套餐和价格信息。

PLCWare 通过原生 Openness 接口控制 Siemens TIA Portal V21，并在工程计算机上将其封装为本地 HTTP/JSON API。创建设备和网络、生成和导入 SCL/SimaticML、管理块/类型/标签，以及运行 编译 → 下载 → 在线——所有功能都通过简洁的 HTTP 接口开放，可由任何应用、脚本或 AI 助手驱动。

它封装了 Openness API 带来的所有复杂性（net48/AMD64 程序集、运行时程序集解析、独占 TiaPortal 的单个串行工作线程），并通过 HTTP 提供服务， 同时配备系统托盘 GUI（启动/停止/监控 API）和用于无头运行的 CLI。

这是产品中心——提供下载、文档和客户支持。该应用为专有软件；其源代码位于单独的私有仓库中。

整体架构

三部分，根据运行位置划分：

部分说明许可证位置
PLCWare app / serve引擎——用于控制 TIA Portal V21 并开放 HTTP/JSON API 的 Windows 应用。本产品。专有（激活许可证）Releases
@renanlido/tia-openness-mcp桥接器——轻量级 MCP→HTTP 客户端，让 AI 工具（Claude、Codex、Gemini、Cursor……）能够驱动 API。MIT（开源）npm
tia-harness客户端工具包——Claude Code 插件（技能 + 子 Agent），可将工程规格转换为经过验证的 TIA 项目。MIT（开源）renanlido/tia-harness

MCP 和工具包均为开源且免费。实际与 TIA Portal 通信的是 serve 应用，它是需要许可的产品。

下载

免费下载。 从Releases页面获取最新安装程序：

  • TIAOpenness-Setup-<version>.exe — 一键安装程序（推荐）：复制应用并运行首次设置（将你添加到 Siemens TIA Openness 组、创建快捷方式、可选设置自动启动），随后打开入门界面。
  • TIAOpenness-app-<version>.zip — 便携版；解压后运行 TIAOpenness.exe setup。

先决条件： Windows 10/11（x64）、.NET Framework 4.8（安装程序会检查），以及已安装 TIA Portal V21 + Openness 组件（应用会从本地安装中加载 Siemens 程序集——不会重新分发这些程序集）。

完整操作步骤请参阅**入门指南**。

语言

该应用提供双语版本——英语 / 葡萄牙语：

  • 桌面应用（GUI、CLI、设置和诊断）会自动检测你的 Windows 语言 （巴西以外的所有地区均使用英语）。你也可以手动选择：在安装向导中、应用的 Language 选择器中，或在命令行中使用 --lang en|pt。
  • 文档和 tia MCP 服务（工具描述、修复提示、消息）使用英语。
  • HTTP API 使用英语；少数面向用户的状态文本（环境检查、许可证状态）会遵循应用配置的语言。

试用——免费下载，持许可证使用

该应用采用**“免费下载，激活许可证后使用”**的模式（类似 JetBrains / Sublime）：

  • 下载公开且免费——任何人都可以安装。
  • **有效的激活许可证可解锁使用权限。**没有许可证时，除 GET /health 外，所有 API 端点都会返回 403 license_required，因此二进制文件在激活前不会执行任何操作。
  • 激活许可证是经过加密签名的令牌，可离线验证——运行时无需向服务器回传信息。

**想要评估吗？**在 plcware.io/en/trial 开始 30 天自助试用：包含 Pro 权限范围，且无需提供银行卡。

方案和许可

方案和价格请查看 plcware.io。 许可证按席位使用授权，提供从检查 / 脚手架到完整的创建 → 编译 → 部署及硬件控制等不同级别。如有许可相关问题，请联系 PLCWare 支持或发送邮件至 [email protected]。

通过 AI 操作（MCP）

该应用不强加特定做法（端点会将参数直接传递给 Openness），因此非常适合由 AI 助手驱动。tia MCP 服务是一个通过 npm 发布的轻量级 HTTP 客户端——将它指向正在运行的 serve 即可：

npx -y @renanlido/tia-openness-mcp

对于 Claude Code（单行命令，用户级作用域）：

claude mcp add --transport stdio --env TIA_API_BASE=http://localhost:5000 --scope user tia -- npx -y @renanlido/tia-openness-mcp

其他客户端（Claude Desktop、Codex、Gemini CLI、Cursor、VS Code、Windsurf）以及 Windows 中 cmd /c npx 的注意事项，请参阅 docs/INSTALL.md。

MCP 绝不会发送密钥——激活由主机负责（在 serve 机器上配置许可证）。如果没有可供连接的已获许可 serve，MCP 只能诊断连接情况（tia_ping）。

MCP 客户端：MIT（参见 LICENSE）。桌面应用：EULA。

如需端到端测试框架，将结构化规格转换为经过验证的 TIA 项目，请安装 tia-harness Claude Code 插件。

指南

plcware.io 提供有关 TIA Portal Openness 的实用指南，支持英语、葡萄牙语、西班牙语和中文：

同一批指南也位于此仓库的 docs/guides 下。

文档

支持与问题反馈

有关联系渠道和响应预期，请参阅 SUPPORT.md。

许可证

PLCWare 应用是专有软件，保留所有权利。使用需要有效的激活许可证；请参阅 EULA。开放的 MCP 和 harness 客户端层在各自的代码库中采用 MIT 许可证。

TIA Portal、TIA、SIMATIC、STEP 7 和 Siemens 是 Siemens AG 的商标。这是一款面向 TIA Portal 的独立产品，与 Siemens 无关联，也未获得 Siemens 背书。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。