A
asckye/eplan-mcp
MCP server that lets AI agents safely read and edit EPLAN Electric P8 / Pro Panel projects through the EPLAN…
★ 6·updated 2026-11-19
View on GitHub ↗Direct link · no redirect page
- Star count
- 6 ★ · asckye/eplan-mcp · read from the GitHub search API · (checked 2026-11-19 20:00:48)
- Source
- read directly from its GitHub page · type: open-source project
- Harvest history
- first seen 2026-11-18 · last seen 2026-11-20 · seen 3× · listed by 2 sources
- Score
- score 203 · 6 ★ · 2 sources · repo
FAQ (answers come from our records)
Who is it for?
We filed it under these tags: Open Source. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
asckye/eplan-mcp;first catalogued 2026-11-18;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.README excerpt (English, untranslated) · Read the full README on GitHub →
# EplanMcp
Excerpted from the repository README (abridged)
简体中文 | English
用对话操作 EPLAN。 EplanMcp 是一个 MCP 服务器,让 Claude Code 等 AI 客户端通过 EPLAN .NET API 读取和修改 EPLAN Electric P8 / Pro Panel 项目:查询项目、绘制原理图、放置设备、更新报表、导出图纸。
工程师始终掌握控制权:写入默认只预览,真实项目逐次审批,操作可撤销、可审计。
这一页由 MCP 工具调用完成:建页、放置设备(-Q1 来自部件库)、自动连线、导出图片,没有手工绘制。图中只保留绘图区。
> [!NOTE]
> 当前是预览版(0.x),供测试使用,工具的参数和返回结构仍可能变化。版本变更见 CHANGELOG,后续计划见路线图。
## 能这样用
连接 AI 客户端后,直接用中文提问或下指令:
“这个项目有多少页?-K1 在哪几页上?”
“哪些电机没有部件?”
“=GAA+A1-FC1 的负载侧接到哪些设备?”
“先建页,再插入一个回路,给我看完整变更和预期结果。”
“把这几页的自由文本中的 Motor 改成 Drive,只改英语,先预览。”
“检查这一页有没有画出图框、符号重叠或导线穿过符号,按建议修好再检查一遍。”
## 为什么不直接让 AI 写 EPLAN 脚本
| | 让 AI 直接写脚本 | 通过 EplanMcp |
| 调用 API | 靠模型的记忆,容易用错或编造接口 | 工具参数固定,调用前校验;API 行为来自官方文档和实机验证 |
| 判断结果 | “返回成功但没有效果”很难发现 | 写入后读回核对,安全项不符自动回滚,其他偏差带警告返回 |
| 修改范围 | 脚本能改任何打开的项目 | 默认只预览,真实项目逐次审批 |
| 改错之后 | 靠人工查找和恢复 | 普通写入一次 Ctrl+Z 恢复,Destructive 操作先备份 |
| 事后追溯 | 说不清改了什么 | 调用记录于审计哈希链 |
## 快速开始
需要: Windows 10/11 x64 · EPLAN 2026 Electric P8 或 Pro Panel,授权须包含 API 扩展并允许加载未签名插件 · 支持 MCP 的客户端,如 Claude Code、Claude Desktop
1. 安装: 从 Releases 下载 EplanMcp- .zip 和 SHA256SUMS.txt,校验后解除 ZIP 锁定,解压到短且固定的位置,如 D:\EplanMcp。
2. 连接: 打开 workbench\EplanMcp.Workbench.exe,勾选 EPLAN 变体注册插件,并配置客户端。
3. 提问: 在 EPLAN 中打开项目,然后问客户端“这个项目有多少页”。
安装无需管理员权限。校验、升级、卸载和虚拟机部署见中文入门指南。
## 能做什么
| 分组 | 能做什么 |
| 读取 | 查询项目、页、设备、连接、电缆、端子、PLC、部件、符号、修订、消息、检查结果、宏、占位符、属性和页面对象 |
| 绘图与修改 | 新建、打开、关闭和改名项目,填写标题栏,管理结构标识符;新建页,从部件库或符号放置设备,插入宏,放置中断点和电位定义点,添加文字与图形,生成连接,修改电位定义点的电位、颜色和截面,删除放置,添加屏蔽,按数据画 PLC 机架,生成 PLC 页和改址,修改属性,替换页面文字;Pro Panel 3D 柜体布置 |
| 检查与报表 | 运行 EPLAN 检查,按工程包规则检查,审查页面的图面(超出图框可用区域、符号重叠、导线穿过符号、文字格式、线号缺失等,并给出修正建议)和规则插件(IEC 60204-1、IEC 81346 等),生成和更新报表 |
| 编号与翻译 | 页面、设备、端子、电缆、连接编号,生成电缆,项目翻译 |
| 导入导出 | 导出 PDF、DXF、图片、PXF、部件清单、标签、未翻译文本;导入 DXF/DWG、PXF、设备/部件清单、PLC 数据、PDF 批注 |
| 部件库与翻译库 | 系统部件库查询、导入、同步与导出;翻译库导入与导出 |
| 工程包与知识 | 安装、启用、查询、构建工程包;绑定柜配置;搜索、审核与更新资源知识;为任务编译上下文 |
| 计划执行 | 把多步操作编成计划,审阅后整体批准执行 |
| 通用 API 层 | 搜索 EPLAN API 与 action,查看调用模板,在安全规则允许的范围内调用 |
完整清单、Profile 与读写注解见工具索引。默认提供全部工具(默认关闭的工具需另行启用),serve --profile core 只提供固定的 25 个工具,够完成“读项目、找符号和部件、画一页、移动和改文字、审图、看图”;删除等 Destructive 工具只在默认的 full 里。
## 工作方式
eplanmcp.exe(Host,.NET 10):通过 stdio 连接 AI 客户端,负责工具、策略、审批和审计。
EplanMcp Bridge(EPLAN 插件,.NET Framework 4.8.1):在 EPLAN 主线程上调用 EPLAN API,通过只对当前用户开放的命名管道连接 Host。
Workbench:注册插件、配置客户端、处理审批。
所有操作都发生在你正在使用的 EPLAN 里。设计细节见架构和 ADR。
## 安全模型
默认预览: 写入工具省略 dry_run 时只返回变更清单,不审批也不写入(ADR-0049)。
逐次审批: 普通写入在 scratch 内自动放行;真实项目默认逐次经 Workbench 或 EPLAN 对话框审批(ADR-0005、ADR-0011)。
先备份: Destructive 操作在 scratch 中也要审批,执行前自动备份,备份失败不执行(ADR-0013)。系统部件库写入同样每次审批并先备份,不能依靠 Ctrl+Z 恢复(ADR-0019)。
可追溯: 调用记录于审计哈希链;结果未知时暂停相关项目与 EPLAN 实例的写入,待工程师核实并经审批渠道确认后解除(ADR-0010)。
## 当前限制
实测版本是 EPLAN 2026.0.3;2024、2025、2027 尚未验证,留待 M7,2022、2023 暂不支持(ADR-0009)。
0.x 发布未签名插件(ADR-0007)。
绘图能做到可用,不保证与已有图纸逐项一致;画完请用页面审查检查,并人工核对。页面审查只查图面和连线,不保证符合标准。Pro Panel 3D 布局已有柜体、导轨、线槽、器件放置和布线工具,其中布线工具尚未实机验证。
已知问题:连续审查大量页面时 EPLAN 偶尔崩溃(原因在查);审查只读,但长时间批量操作前请先保存 EPLAN 里的修改。
AI 可能出错:请先在 scratch 项目上试,并在批准前检查预览内容。
工具返回的项目内容会进入 AI 客户端,是否发送到模型服务取决于你使用的客户端和模型;处理客户项目前请确认符合保密要求。EplanMcp 的安装与本机连接不需要联网。
用对话操作 EPLAN。 EplanMcp 是一个 MCP 服务器,让 Claude Code 等 AI 客户端通过 EPLAN .NET API 读取和修改 EPLAN Electric P8 / Pro Panel 项目:查询项目、绘制原理图、放置设备、更新报表、导出图纸。
工程师始终掌握控制权:写入默认只预览,真实项目逐次审批,操作可撤销、可审计。
这一页由 MCP 工具调用完成:建页、放置设备(-Q1 来自部件库)、自动连线、导出图片,没有手工绘制。图中只保留绘图区。
> [!NOTE]
> 当前是预览版(0.x),供测试使用,工具的参数和返回结构仍可能变化。版本变更见 CHANGELOG,后续计划见路线图。
## 能这样用
连接 AI 客户端后,直接用中文提问或下指令:
“这个项目有多少页?-K1 在哪几页上?”
“哪些电机没有部件?”
“=GAA+A1-FC1 的负载侧接到哪些设备?”
“先建页,再插入一个回路,给我看完整变更和预期结果。”
“把这几页的自由文本中的 Motor 改成 Drive,只改英语,先预览。”
“检查这一页有没有画出图框、符号重叠或导线穿过符号,按建议修好再检查一遍。”
## 为什么不直接让 AI 写 EPLAN 脚本
| | 让 AI 直接写脚本 | 通过 EplanMcp |
| 调用 API | 靠模型的记忆,容易用错或编造接口 | 工具参数固定,调用前校验;API 行为来自官方文档和实机验证 |
| 判断结果 | “返回成功但没有效果”很难发现 | 写入后读回核对,安全项不符自动回滚,其他偏差带警告返回 |
| 修改范围 | 脚本能改任何打开的项目 | 默认只预览,真实项目逐次审批 |
| 改错之后 | 靠人工查找和恢复 | 普通写入一次 Ctrl+Z 恢复,Destructive 操作先备份 |
| 事后追溯 | 说不清改了什么 | 调用记录于审计哈希链 |
## 快速开始
需要: Windows 10/11 x64 · EPLAN 2026 Electric P8 或 Pro Panel,授权须包含 API 扩展并允许加载未签名插件 · 支持 MCP 的客户端,如 Claude Code、Claude Desktop
1. 安装: 从 Releases 下载 EplanMcp- .zip 和 SHA256SUMS.txt,校验后解除 ZIP 锁定,解压到短且固定的位置,如 D:\EplanMcp。
2. 连接: 打开 workbench\EplanMcp.Workbench.exe,勾选 EPLAN 变体注册插件,并配置客户端。
3. 提问: 在 EPLAN 中打开项目,然后问客户端“这个项目有多少页”。
安装无需管理员权限。校验、升级、卸载和虚拟机部署见中文入门指南。
## 能做什么
| 分组 | 能做什么 |
| 读取 | 查询项目、页、设备、连接、电缆、端子、PLC、部件、符号、修订、消息、检查结果、宏、占位符、属性和页面对象 |
| 绘图与修改 | 新建、打开、关闭和改名项目,填写标题栏,管理结构标识符;新建页,从部件库或符号放置设备,插入宏,放置中断点和电位定义点,添加文字与图形,生成连接,修改电位定义点的电位、颜色和截面,删除放置,添加屏蔽,按数据画 PLC 机架,生成 PLC 页和改址,修改属性,替换页面文字;Pro Panel 3D 柜体布置 |
| 检查与报表 | 运行 EPLAN 检查,按工程包规则检查,审查页面的图面(超出图框可用区域、符号重叠、导线穿过符号、文字格式、线号缺失等,并给出修正建议)和规则插件(IEC 60204-1、IEC 81346 等),生成和更新报表 |
| 编号与翻译 | 页面、设备、端子、电缆、连接编号,生成电缆,项目翻译 |
| 导入导出 | 导出 PDF、DXF、图片、PXF、部件清单、标签、未翻译文本;导入 DXF/DWG、PXF、设备/部件清单、PLC 数据、PDF 批注 |
| 部件库与翻译库 | 系统部件库查询、导入、同步与导出;翻译库导入与导出 |
| 工程包与知识 | 安装、启用、查询、构建工程包;绑定柜配置;搜索、审核与更新资源知识;为任务编译上下文 |
| 计划执行 | 把多步操作编成计划,审阅后整体批准执行 |
| 通用 API 层 | 搜索 EPLAN API 与 action,查看调用模板,在安全规则允许的范围内调用 |
完整清单、Profile 与读写注解见工具索引。默认提供全部工具(默认关闭的工具需另行启用),serve --profile core 只提供固定的 25 个工具,够完成“读项目、找符号和部件、画一页、移动和改文字、审图、看图”;删除等 Destructive 工具只在默认的 full 里。
## 工作方式
eplanmcp.exe(Host,.NET 10):通过 stdio 连接 AI 客户端,负责工具、策略、审批和审计。
EplanMcp Bridge(EPLAN 插件,.NET Framework 4.8.1):在 EPLAN 主线程上调用 EPLAN API,通过只对当前用户开放的命名管道连接 Host。
Workbench:注册插件、配置客户端、处理审批。
所有操作都发生在你正在使用的 EPLAN 里。设计细节见架构和 ADR。
## 安全模型
默认预览: 写入工具省略 dry_run 时只返回变更清单,不审批也不写入(ADR-0049)。
逐次审批: 普通写入在 scratch 内自动放行;真实项目默认逐次经 Workbench 或 EPLAN 对话框审批(ADR-0005、ADR-0011)。
先备份: Destructive 操作在 scratch 中也要审批,执行前自动备份,备份失败不执行(ADR-0013)。系统部件库写入同样每次审批并先备份,不能依靠 Ctrl+Z 恢复(ADR-0019)。
可追溯: 调用记录于审计哈希链;结果未知时暂停相关项目与 EPLAN 实例的写入,待工程师核实并经审批渠道确认后解除(ADR-0010)。
## 当前限制
实测版本是 EPLAN 2026.0.3;2024、2025、2027 尚未验证,留待 M7,2022、2023 暂不支持(ADR-0009)。
0.x 发布未签名插件(ADR-0007)。
绘图能做到可用,不保证与已有图纸逐项一致;画完请用页面审查检查,并人工核对。页面审查只查图面和连线,不保证符合标准。Pro Panel 3D 布局已有柜体、导轨、线槽、器件放置和布线工具,其中布线工具尚未实机验证。
已知问题:连续审查大量页面时 EPLAN 偶尔崩溃(原因在查);审查只读,但长时间批量操作前请先保存 EPLAN 里的修改。
AI 可能出错:请先在 scratch 项目上试,并在批准前检查预览内容。
工具返回的项目内容会进入 AI 客户端,是否发送到模型服务取决于你使用的客户端和模型;处理客户项目前请确认符合保密要求。EplanMcp 的安装与本机连接不需要联网。
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/asckye-eplan-mcp/)
- Source
- github · https://github.com/asckye/eplan-mcp
- Browse by field
- Open source
- Traction
- 6 ★
- Listed by
- 2 independent sources
- added
- today
More entries
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.