内容
TIA 门户 MCP 服务器
一款 MCP（模型上下文协议）服务器，使 AI 助手能够分析西门IA 门户工业自动化项目。提取、搜索和分析 PLC 代码、控制逻辑、报警和安全系统。
## 功能特点
- **结构** - 将 TIA 门户项目导出为有组织的、可搜索的文件结构
- **控制回路分析** - 分析 PID 控制器、跟踪回路、识别串级/前馈配置
- **信号流图** - 构建依赖图、跟踪信号路径、检测反馈回路
- **定时器和序列分析** - 分析定时器、跟踪步序、识别监视器 **报警分析** - 触发条件、原因-效果矩阵、洪水风险检测
- **安全分析** - 跳闸逻辑、互锁条件、SIF识别
## 要求
- Windows（TIA 门户要求）
- Python 3.8+
- TIA 门户 V13+，启用开放性
- NetworkX（用于逻辑图功能）
## 安装
```bash
# 克隆仓库
git clone https://github.com/your-org/tia-portal-mcp.git
cd tia-portal-mcp
# 设置虚拟环境
python -m venv .venv
.venv\Scripts\activate # Windows
# source .venv/bin/activate # Linux/Mac
# 安装依赖项
pip install -r requirements.txt
# 注册 TIA 门户 DLL（仅 Windows）
register_tia_dlls.bat
# 启动服务器
python server_structured.py
```
## 使用方法
### 1. 连接到 TIA 门户
```
connect_to_tia()
open_project("C:/path/to/project.ap17")
```
### 2. 创建导出
```
create_structured_export("my_analysis")
```
### 3. 分析
```
# 构建信号流图
build_logic_graph()
# 跟踪信号依赖关系
analyze_signal_dependencies("PUMP_1.RUN")
# 分析 PID 控制器
analyze_pid_controller("FIC_101")
# 检查安全互锁
lock_conditions("V-```
## 可用工具）
| 类别工具 |
|----------|-------|
| **导出** | `create_structured_export`, `load_structured_export`, `list_structured_exports` |
| **搜索** | `search_export_equipment`, `get_export_structure`, `get_search_guide` |
| **数据流** | `trace_signal_dataflow`, `get_project_dataflow_statistics` |
| **控制** | `analyze_pid_controller`,_control_loop`, `generate_pid_tuning_report`, `find_control_loop_interactions` |
| **定时器** | `_logic`, `trace_sequence_logic`, `find_watchdog_tim `analyze_pulse_g` |
| **报警** | `analyze_alarm_triggers`, `generate_alarm_matrix`, `find_alarm_floisks` |
| ** | `analyze_trip_logic`, `trace_interlock_conditions`, `find_safety_functions`,_interlock_matrix` |
| **逻辑图** | `build_logic_graph`, `analyze_signal_dependencies`, `trace_logic_path`, `detect_logic_cycles`, `analyze_timing_paths` |
## 导出结构
```
export_name/
├── raw/ # PLC 原始 XML
│ └── PANEL_1/
│ ├── INTERLOCKS.xml
│ └── ALAR
├── parsed/ 处理后的索引
│ ├── operands/
│ ├── equipment/
│ └── cross_references/
├── search/ # 搜索优化的文本文件
└── metadata.json
```
## 兼容客户端
- Claude Code CLI
- Codex CLI
- Claude 代理 SDK
- 任何 MCP 兼容的 AI 客户端
## 安全
所有 TIA 门户操作均为**只读**。服务器无法修改项目。
## 文档
- [ROADMAP.md](ROADMAP.md) - 开发状态和未来计划
- [MCP_TOOLS.mdCP_TOOLS.md) - 详细工具- [TROUBLESHOOTING.mdROUBLESHOOTING.md 常见问题
许可证
MIT 许可证 - 请参阅 [LICENSE](LICENSE)
MCP 市场