# TiaMcp

> MCP server for Siemens TIA Portal Openness - offline inspection, export/import and controlled editing of PLC/HMI projects from AI agents. 让 AI Agent 读写西门子博图工程。

- **Type:** MCP server
- **Install:** `agentstack add mcp-newcovid-tiamcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [newcovid](https://agentstack.voostack.com/s/newcovid)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [newcovid](https://github.com/newcovid)
- **Source:** https://github.com/newcovid/TiaMcp

## Install

```sh
agentstack add mcp-newcovid-tiamcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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 安装目录加载。

## 构建

```powershell
.\build.ps1
```

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

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

## 命令行使用

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

```powershell
.\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 服务：

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

典型 MCP 客户端配置如下：

```json
{
  "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 工程数据可能包含源代码、设备组态、网络拓扑、画面布局、变量名、注释、作者字段和本地路径。请将工具输出视为工程数据处理：

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

```powershell
.\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](https://github.com/newcovid)
- **Source:** [newcovid/TiaMcp](https://github.com/newcovid/TiaMcp)
- **License:** Apache-2.0

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-newcovid-tiamcp
- Seller: https://agentstack.voostack.com/s/newcovid
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.