TiaMcp

TiaMCP

TiaMCP 是一个本地优先的 C# 控制台应用和 MCP stdio 服务，用于通过 Siemens TIA Portal Openness 对 TIA Portal 工程进行离线检查、导出、导入和受控编辑。

项目面向工程数据分析、代码审查、批量整理和本地 AI 辅助工程工作流。它会连接到已经打开的 TIA Portal 实例，读取工程对象，调用 Openness API 执行受支持的离线操作，并通过命令行或 MCP 工具接口返回结果。

> 安全边界：TiaMCP 不是在线 PLC 控制工具。仓库中的公开版本不提供 PLC 下载/上传、RUN/STOP 切换、在线强制、在线实际值读取、诊断缓冲区读取或在线网络调试能力。

功能概览

• 工程、设备、硬件和网络组态的离线读取。
• PLC 块、变量表、UDT、监控表和项目文本的读取、导出、导入和编译辅助。
• SCL/STL 源码和 SimaticML XML 的受控导出与导入。
• PLC 变量、UDT、块重命名、块号设置等离线重构辅助，并为破坏性操作提供 --dry-run 预演。
• 经典 HMI 设备的画面、模板、变量、连接、文本列表和图形列表读取/导出/导入辅助。
• 基于导出文本/XML 的交叉引用、依赖关系、调用树和未使用对象候选分析。
• MCP stdio 集成，可让本地 MCP 客户端通过 JSON-RPC 调用受支持工具。

非目标

TiaMCP 不应被用作生产现场在线控制接口，也不应托管真实工程资产。本仓库不包含：

• 真实 TIA Portal 工程、归档、PLC/HMI 导出文件或生成产物；
• 客户、公司、现场、机器、PLC、HMI、画面、变量、DB、块、IP、订货号、序列号或路径等标识信息；
• 私人笔记、本地 AI 记忆、审计草稿、截图、PDF 手册或第三方专有资料副本；
• 密码、许可证密钥、API token、证书、SSH key 或其他凭据。

运行要求

• Windows 环境。
• 已安装并授权使用 Siemens TIA Portal 和 TIA Portal Openness。
• 当前 Windows 用户已被允许访问 TIA Portal Openness。
• .NET Framework 4.8 构建支持。
• x64 构建和运行环境。不要使用 x86 或 AnyCPU。

Siemens Openness 程序集不会随仓库分发。构建和运行时会从本机 TIA Portal 安装目录加载。

构建

.\build.ps1

如果 TIA Portal 安装在非默认位置，可以通过环境变量指定 PublicAPI 目录：

$env:TIAPORTAL_PUBLICAPI_V18 = 'C:\Program Files\Siemens\Automation\Portal V18\PublicAPI\V18'
.\build.ps1

命令行使用

先手动打开 TIA Portal 并加载目标工程，再在本地可信终端中运行命令：

.\bin\Release\net48\TiaMcp.exe list
.\bin\Release\net48\TiaMcp.exe project-info
.\bin\Release\net48\TiaMcp.exe export-source  

对写入、删除、导入、重命名或重新编号等操作，建议先使用 --dry-run 预演。

MCP 使用

启动 stdio MCP 服务：

.\bin\Release\net48\TiaMcp.exe mcp

典型 MCP 客户端配置如下：

{
  "mcpServers": {
    "tia": {
      "type": "stdio",
      "command": "C:\\path\\to\\TiaMcp.exe",
      "args": ["mcp"]
    }
  }
}

更多说明见 [docs/MCP-SETUP.md](docs/MCP-SETUP.md)。命令清单见 [docs/COMMAND-MANUAL.md](docs/COMMAND-MANUAL.md)，架构说明见 [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)。

数据与隐私

TIA Portal 工程数据可能包含源代码、设备组态、网络拓扑、画面布局、变量名、注释、作者字段和本地路径。请将工具输出视为工程数据处理：

• 不要提交真实工程、导出文件、日志或本地临时产物。
• 提交前运行隐私审计脚本。
• 只提交通用产品代码、泛化文档和合成示例。
• 对任何来自真实工程的输出先做脱敏和人工复核。

.\scripts\privacy-audit.ps1

贡献

欢迎提交通用能力增强、缺陷修复、文档改进和测试用例。贡献前请阅读 [CONTRIBUTING.md](CONTRIBUTING.md)，并确保示例和说明不包含真实工程信息。

许可证

本项目采用 [Apache License 2.0](LICENSE) 授权。

简要说明：在遵守许可证和版权声明保留、修改说明等条件的前提下，用户可以使用、复制、修改和分发本项目；本项目按“原样”提供，不附带任何形式的明示或默示担保。完整法律文本以仓库根目录的 [LICENSE](LICENSE) 文件为准。

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: newcovid
• Source: newcovid/TiaMcp
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.