Skip to content
Back to search

jlceda-mcp

Zero-bridge CDP & REA-powered deterministic hardware design MCP server for JLCEDA Pro (EasyEDA Pro)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/lyufeng000--jlceda-mcp/badge.svg)](/listings/lyufeng000--jlceda-mcp)

HTML

<a href="/listings/lyufeng000--jlceda-mcp"><img src="/api/listings/lyufeng000--jlceda-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 235 lines
  1. <div align="center">
  2. # ⚡ JLCEDA Pro MCP (`jlceda-mcp`)
  3. **让 AI 在嘉立创EDA 专业版中真正画出“能打板、不炸机、零幻觉”的硬件电路**
  4. [![MCP](https://img.shields.io/badge/Protocol-MCP-111827?style=flat-square)](https://modelcontextprotocol.io)
  5. [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D26.0-339933?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org)
  6. [![Platform](https://img.shields.io/badge/Platform-Windows-0078D6?style=flat-square&logo=windows&logoColor=white)](#快速上手)
  7. [![Tools](https://img.shields.io/badge/MCP%20Tools-43-2563EB?style=flat-square)](#mcp-工具清单6-层共-43-个)
  8. [![Tests](https://img.shields.io/badge/Tests-105%20Passing-16A34A?style=flat-square)](#cli-与开发验证)
  9. [为什么用它](#为什么选择-jlceda-mcp) · [快速上手](#快速上手) · [使用示例](#你可以这样对-ai-说) · [闭环架构](#设计闭环架构) · [43 个工具清单](#mcp-工具清单6-层共-43-个)
  10. </div>
  11. ---
  12. ## 为什么选择 `jlceda-mcp`
  13. 普通 AI 画电路最大的问题不是“画不出来”,而是**编造引脚号、靠猜连线、不管热环路与封装间距,最后板子根本没法贴片打样**。`jlceda-mcp` 通过原生 CDP 协议直连本地嘉立创EDA 专业版,用一套确定性工程护栏把 AI 的自由发挥锁进硬件工程边界内:
  14. | 常见痛点 | 普通 AI / 脚本方案 | `jlceda-mcp` |
  15. | --- | --- | --- |
  16. | **引脚与封装幻觉** | 凭记忆写引脚编号,极易接反烧芯片 | 强制 `jlc_datasheet_extract` 绑定真实库引脚与 CESM 真值模型 |
  17. | **网表误判** | 读取导线二维坐标硬算连通,经常漏连或误连 | 100% 唯一采信官方编译器 `eda.sch_Netlist` 权威网表 |
  18. | **原理图带病转 PCB** | 缺少硬门禁,电源反接/悬空直接带进板子 | 内置 **28 条 `ELINT` 电气硬检**,0 Blocker 方可解锁同步 |
  19. | **布局布线不可用** | 器件乱堆、铜皮孤岛、FB 紧贴 SW 干扰节点 | Leiden 聚类 + 原厂 `Layout Example` 优先 + 四级布线 + **18 条 2.5D `PLINT`** |
  20. | **大板审计噪音与盲区误判** | 数百条重复告警刷屏;把铺铜未重建、DRC 中止或 2 层板底层误铺铜当成“通过” | 去重折叠五列摘要 + EasyEDA `source` 奇偶自检与逐层二值判铜 + `uncoveredItems` 盲区显式声明 |
  21. | **客户端配置繁琐** | 每个 AI 客户端都要复制一大坨路径 `env` | **环境与挂载解耦**:`setup` 一次托管至 `~/.jlceda-mcp/config.json`,客户端**零 `env`** |
  22. ---
  23. ## 快速上手
  24. ### 前置条件
  25. - **Windows** + 已安装 **嘉立创EDA 专业版(EasyEDA Pro)**
  26. - **Node.js `>= 26.0.0`**(原生启用 `node:sqlite` 与 FTS5,无需本地 C++ 编译工具链)
  27. ### 第 1 步:安装依赖并初始化本机环境(只需一次)
  28. ```bash
  29. npm install
  30. npm run build
  31. npm run setup
  32. ```
  33. `npm run setup` 会自动完成三件事,且**默认不修改任何 AI 客户端配置文件**:
  34. 1. 自动探测本机嘉立创EDA 专业版路径(默认目录 / Windows 注册表),未检测到时交互提示输入并校验 `lceda-pro.exe`;
  35. 2. 构建无伪源码全量 API 索引(`~/.jlceda-mcp/catalog/api_catalog.sqlite`);
  36. 3. 将环境配置持久化到 `~/.jlceda-mcp/config.json`,并打印各客户端的极简注册方式。
  37. > 非交互式环境可直接指定客户端目录:`node dist/cli.js setup --client-dir "D:\Path\To\lceda-pro"`。
  38. ### 第 2 步:注册到你的 AI 客户端(零 `env` 配置)
  39. 因为客户端路径与索引位置已统一托管在 `~/.jlceda-mcp/config.json`,挂载片段**不需要填写任何 `env`**:
  40. - **Claude Code**
  41. ```bash
  42. claude mcp add jlceda-pro -- node "<项目绝对路径>/dist/index.js"
  43. ```
  44. - **Codex**
  45. ```bash
  46. codex mcp add jlceda-pro -- node "<项目绝对路径>/dist/index.js"
  47. ```
  48. - **Antigravity / Cursor / 其他 MCP 客户端**(合并进 `mcp_config.json`)
  49. ```json
  50. {
  51. "mcpServers": {
  52. "jlceda-pro": {
  53. "command": "node",
  54. "args": ["<项目绝对路径>/dist/index.js"]
  55. }
  56. }
  57. }
  58. ```
  59. > Antigravity 用户也可以显式执行 `node dist/cli.js setup --write-antigravity` 自动无损合并(卸载:`node dist/cli.js uninstall --antigravity`);随时可用 `npm run print-config` 重新打印上述片段。
  60. ---
  61. ## 你可以这样对 AI 说
  62. 挂载完成后,直接用自然语言驱动完整硬件设计流程:
  63. > **1. 从零设计一块可打样板卡**
  64. > “打开嘉立创EDA,新建一个 24V 转 5V/3.3V 的工业 RS485 采集板工程:先在立创基础库选型并解析 Datasheet,完成原理图绘制与 28 条电气审计,再按模块聚类布局、优先布好功率环路和差分线、铺铜加防立碑焊盘,最后跑总门禁并导出 Gerber、BOM 和 CPL。”
  65. > **2. 接手老工程做硬核体检(只读复核)**
  66. > “只读连接我当前打开的嘉立创工程,读取权威网表跑一遍 `jlc_elec_lint` 和 `jlc_pcb_drc_and_lint`:按去重折叠摘要列出所有 Blocker(含 2 层板敏感器件底层误铺铜与单层禁布区漏配),把 `uncoveredItems` 里的未覆盖/降级项一并说明,并用 `jlc_view_capture` 截图对照原厂 Datasheet `Layout Example` 给我整改建议。”
  67. > **3. 精准计算并复用标准子电路**
  68. > “帮我算一下 12V 转 3.3V/2A 同步 Buck 的电感电容和分压反馈电阻(吸附到 E96 标准值),然后直接实例化一个标准 Type-C 5V UFP 供电积木和 PMOS 防反接积木。”
  69. ---
  70. ## 设计闭环架构
  71. ```mermaid
  72. flowchart LR
  73. A["1. 环境与会话<br/>jlc_launch / jlc_connect"] --> B["2. 选型与真值绑定<br/>LCSC + Datasheet CESM + 计算器"]
  74. B --> C["3. 原理图与仿真<br/>9 大黄金积木 + 无十字连线 + SPICE"]
  75. C --> D{"4. 电气硬检门禁<br/>28 条 ELINT = 0 Blocker"}
  76. D -- "未通过:定位修复" --> C
  77. D -- "通过:ECO 同步" --> E["5. 模块化布局与四级布线<br/>Leiden 聚类 → 原厂拓扑 → FreeRouting → 铺铜"]
  78. E --> F{"6. 交付总门禁<br/>原生 DRC + 18 条 PLINT + 视觉比对"}
  79. F -- "未通过:回滚精调" --> E
  80. F -- "通过:交付" --> G["7. 制造文件导出<br/>Gerber / BOM / CPL / STEP"]
  81. ```
  82. ### 核心工程原则与安全边界
  83. - **零伪源码落盘**:REA 逆向索引全程在内存中解析 `.d.ts` 与 AST 特征指纹,严格保证 **0 字节反编译源码写入磁盘**,并内置 `verify-zero-source` 审计门禁。
  84. - **零侵入原软件**:不修改嘉立创EDA 安装目录内任何原始文件(保护 `innerSign` 签名完整),不绕过官方登录/激活机制,不强杀用户已打开的编辑窗口。
  85. - **双引擎确定性护栏**:用确定性数学计算器 + 官方编译态网表 + 28 条 `ELINT` + 18 条 2.5D `PLINT` + 四合一 `jlc_validate` 兜底,消除大模型数值与几何幻觉。
  86. - **证据链、降噪折叠与盲区显式声明**:所有审计报告自动执行“定位指纹去重 → 严重度排序 → 同类高频 `WARNING` 折叠(`BLOCKER` 永不折叠)”并输出 `normalizedSummary`;EasyEDA `source` 多轮廓按奇偶规则(Even-Odd)解析并用平台 `bbox`/双圆弧自检;凡铺铜未实体化、DRC 因 `Netlist Error` 中止、叠层介电常数缺失或局部单页编译,均写入 `uncoveredItems`,严格贯彻**采集缺失 ≠ 检查通过**。
  87. - **事务原子保护**:支持跨多步工具调用的 Undo 事务边界(`jlc_transaction`)与交付前自动释放文件锁(`releaseProcess=true`)。
  88. ---
  89. ## MCP 工具清单(6 层共 43 个)
  90. <details open>
  91. <summary><strong>第 1 层:环境配置、会话连接、文档与句柄管理(16 个)</strong></summary>
  92. | 工具名 | 核心用处 | 典型使用场景 |
  93. | --- | --- | --- |
  94. | `jlc_configure` | 自动扫描或手动配置嘉立创EDA 专业版路径,校验后持久化至 `~/.jlceda-mcp/config.json` 并热更新当前会话 | 首次运行未检测到客户端、客户端换目录迁移,或修改 CDP 端口/求解器路径 |
  95. | `jlc_launch` | 按合规白名单 CDP 参数启动本机嘉立创EDA 专业版,不强杀已有用户窗口 | 尚未打开嘉立创EDA,需由 MCP 拉起客户端并准备调试连接 |
  96. | `jlc_connect` | 智能扫描进程与窗口 Z-Order,过滤欢迎页/DevTools,直连正在编辑的原理图或 PCB 实例 | 开始协同改图或建立 CDP 会话(`launch=false` 用于只读安全探测) |
  97. | `jlc_session_status` | 独立于主 RPC 队列只读诊断所有 `lceda-pro.exe` 进程、CDP 连通性与阻塞弹窗状态 | 排查客户端卡顿、未激活登录态或超时无响应原因 |
  98. | `jlc_capabilities` | 查询安装路径、REA 接口库分级统计(L1~L4)、L3 适配器健康度及外部求解器状态 | 会话初始化核验环境能力、确认 FreeRouting/ngspice 或索引是否就绪 |
  99. | `jlc_documents` | 列出当前已打开工程及所有原理图页、PCB、符号/封装文档状态、脏标记与选中数量 | 查看当前工程结构、确认未保存改动或定位目标文档句柄 |
  100. | `jlc_document_new` | 新建离线 `.epro` 工程,或在当前工程内新增原理图图纸 / PCB 文件 | 从零新建硬件工程或拆分多页原理图 |
  101. | `jlc_document_open` | 打开本地 `.epro` / `.epro2` 工程,自动检测跨实例文件占用冲突 | 接手已有本地工程进行修改、审计或批量导出 |
  102. | `jlc_document_activate` | 切换并激活指定原理图页或 PCB 标签页,同步切换底层 CDP 执行上下文 | 在多页原理图与 PCB 之间来回切换操作目标 |
  103. | `jlc_document_save` | 原地保存工程,或静默导出 Gerber / BOM / CPL / PDF / SVG / STEP / DSN 及回导 SES | 阶段性存盘、导出嘉立创打样/SMT 生产包,或对接外部布线器 |
  104. | `jlc_document_close` | 关闭指定文档或工程并释放文件锁;传 `releaseProcess=true` 可同步退出空闲后台进程 | 离线改图交付给用户前释放独占锁,确保双击可正常打开工程 |
  105. | `jlc_select` | 只读提取用户界面当前鼠标选中的图元(不清空高亮),或按句柄/网络设置选择集 | 读取用户刚框选的器件/走线,或在画布上高亮定位问题图元 |
  106. | `jlc_reference_create` | 为器件、引脚、焊盘或图元生成带 CRC32 校验的 Base64 跨会话持久引用令牌 | 跨多轮对话或重启会话稳定追踪同一关键实体 |
  107. | `jlc_reference_resolve` | 将持久引用令牌解析回当前会话句柄;实体失效或删除时返回 `ERR_REF_STALE` | 恢复上一轮保存的关键器件/焊盘引用并校验拓扑是否变更 |
  108. | `jlc_array_read` | 对超过 200 项的图元、引脚、焊盘、网表或 DRC 违例数组游标(`jlc_arr:*`)分页读取 | 处理大型工程全量对象或大网表,避免单次响应超长截断 |
  109. | `jlc_transaction` | 显式控制跨多步工具调用的组合 Undo 事务边界(`begin` / `commit` / `rollback` / `list_history`) | 批量布局、批量改线或重构子电路前开启事务,出错一键原子回滚 |
  110. </details>
  111. <details>
  112. <summary><strong>第 2 层:REA 动态接口反射(3 个)</strong></summary>
  113. | 工具名 | 核心用处 | 典型使用场景 |
  114. | --- | --- | --- |
  115. | `jlc_api_search` | 在无伪源码 SQLite FTS5 索引中按中英文关键词、领域与等级(L1~L4)执行 BM25 检索 | 现有高层工具未覆盖某项冷门原生操作时,查找对应的嘉立创底层接口 |
  116. | `jlc_api_describe` | 读取目标接口的完整机器签名、参数类型、物理量单位契约、前置条件与置信度 | 调用 `jlc_api_invoke` 前核实参数格式与单位,避免盲调报错 |
  117. | `jlc_api_invoke` | 动态执行经检索确认的 L1 官方 `eda.*`、L2 命令、L3 引擎能力或 L4 白名单 IPC(拦截 `BLOCKED`) | 调用高级/冷门原生功能,自动处理 mm/mil 换算、`$ref`/`$enum` 与事务回滚 |
  118. </details>
  119. <details>
  120. <summary><strong>第 3 层:器件库、数据手册解析与确定性计算(5 个)</strong></summary>
  121. | 工具名 | 核心用处 | 典型使用场景 |
  122. | --- | --- | --- |
  123. | `jlc_lib_search` | 联合检索嘉立创系统库、本地库与立创商城(LCSC)目录,支持 C 编号、封装与 SMT 基础库筛选 | 选型阶段查找现货、立创 SMT 基础库/扩展库料号与对应封装 |
  124. | `jlc_lib_device_inspect` | 提取选定器件符号与封装的 100% 真实引脚定义、焊盘公制坐标、孔径、极性与 3D 高度 | 接线或画封装前核实真实引脚编号与焊盘尺寸,杜绝编造引脚 |
  125. | `jlc_datasheet_extract` | 解析 PDF Datasheet 并对齐官方库引脚,生成并绑定标准器件电气模型(CESM)与原厂 `Layout Example` | **放置器件前必调**:建立绝对最大额定值、热阻、推荐外围与布局约束真值 |
  126. | `jlc_lib_custom_create` | 按 IPC-7351 标准参数化生成冷门器件的公制封装与原理图符号,并绑定已验证 CESM | 立创库中缺失冷门芯片/连接器,需要按规格书尺寸自动建库 |
  127. | `jlc_elec_calc` | 内置 9 大确定性电气计算器(分压、LDO 热耗、DC-DC 电感电容、晶振负载电容、I2C 上拉、RC 滤波、LED/光耦、MOS 损耗、线宽温升压降),自动吸附 E24/E96 序列 | 计算阻容感选值、校验热功耗和载流能力,用确定性数学公式替代心算估算 |
  128. </details>
  129. <details>
  130. <summary><strong>第 4 层:原理图绘制、标准积木与 SPICE 仿真(7 个)</strong></summary>
  131. | 工具名 | 核心用处 | 典型使用场景 |
  132. | --- | --- | --- |
  133. | `jlc_sch_sheet_manage` | 创建/重排原理图分页、配置 A4/A3 图框标题栏,并在图纸上绘制功能模块分区虚线框与注释 | 搭建多页原理图骨架、按电源/主控/接口清晰划分图纸功能区 |
  134. | `jlc_sch_component_place` | 在原理图放置真实库器件(硬门禁校验 CESM 绑定),写入位号、参数值、坐标与 `clusterGroup` 分组标签 | 放置已完成选型与 Datasheet 真值绑定的芯片及外围阻容 |
  135. | `jlc_sch_block_instantiate` | 一键实例化 9 大工程验证黄金子电路积木(Type-C UFP、PMOS 防反接、同步 Buck、低噪 LDO、MCU 最小系统、无源晶振、继电器驱动、RS485/CAN、RJ45 Bob-Smith) | 快速复用成熟标准电路,自动完成内部器件排布与无十字交叉连线 |
  136. | `jlc_sch_wire_connect` | 执行引脚正交自动连线、放置网络标签/电源地符号与非连接标记,禁止四向十字交叉(强制错开 `>=2.54mm` 为双 T 节点) | 原理图模块内与跨模块电气互联,保持图纸规范可读 |
  137. | `jlc_sch_netlist_query` | 100% 唯一调用官方编译器 `eda.sch_Netlist` 导出权威编译态结构化网表 | 核对真实电气连通关系、排查悬空/短接网络,或向审计/聚类提供真值网表 |
  138. | `jlc_spice_run` | 驱动嘉立创内置仿真引擎或本地无头 ngspice / MNA 求解器运行 OP/TRAN/AC/DC 仿真并校验定量断言 | 投板前验证分压、滤波频响、电源上电瞬态或偏置工作点是否达标 |
  139. | `jlc_sch_sync_to_pcb` | 将原理图正向同步(ECO)到目标 PCB(硬门禁:必须先通过 `jlc_elec_lint` 0 Blocker) | 原理图审校清零后,安全导入封装与网表进入 PCB 布局布线阶段 |
  140. </details>
  141. <details>
  142. <summary><strong>第 5 层:PCB 模块化布局与四级自动布线(8 个)</strong></summary>
  143. | 工具名 | 核心用处 | 典型使用场景 |
  144. | --- | --- | --- |
  145. | `jlc_pcb_board_setup` | 定义板框、铣槽/隔热槽、层叠结构、安装孔、分层 2.5D Keep-out,并双向同步工程原生 DRC 与 NetClass | PCB 开板初始化,设定 2/4/6 层板叠层、工艺线宽线距与机械禁布区 |
  146. | `jlc_pcb_cluster_netlist` | 基于权威网表剥离全局电源/地,执行去耦电容重绑定与加权 Leiden 图聚类,切分为功能子模块 | 布局前自动识别电源、时钟、高速接口等紧密关联器件组,为模块化分区打底 |
  147. | `jlc_pcb_layout_apply` | 按“原厂 `Layout Example` > 工程 DRC > 四维最小间距矩阵”执行宏观分区求解或显式微调,确保 Courtyard 零重叠 | 一键完成无碰撞模块化布局,或在审查后对单个器件做毫米级精调 |
  148. | `jlc_pcb_route_critical` | 第 1 级关键网络参数化先布并加锁(原厂铜区/过孔阵、去耦微回路、DC-DC 热环路、TVS 穿焊盘零残桩、晶振包地、采样电阻开尔文引出、差分对) | 自动布线前优先锁定电源功率回路与敏感高速/模拟信号的高质量走线 |
  149. | `jlc_pcb_via_place` | 放置单颗过孔、大电流换层并联过孔阵、射频屏蔽过孔墙或芯片底部 GND EPAD 散热过孔阵 | 处理大电流换层载流、QFN/PowerPAD 散热,或射频/敏感区域屏蔽隔离 |
  150. | `jlc_pcb_autoroute` | 第 2 级常规信号自动布线闭环,支持无头 FreeRouting(DSN→多趟推挤重布→SES)及内置 45° A* 路由器 | 关键线锁定后,自动完成剩余大量常规控制/低速信号线的连通与避让 |
  151. | `jlc_pcb_pour_and_stitch` | 第 3 级多边形铺铜、死铜孤岛清除、0603/0402/0201 强制 4 辐条防立碑隔热焊盘与网格/板边 GND 缝合过孔阵 | 布线完成后铺设完整地/电源铜皮,降低回流阻抗并满足 SMT 回流焊工艺 |
  152. | `jlc_pcb_silkscreen_tidy` | 统一丝印 0°/90° 正交朝向,自动避让裸铜焊盘与开窗过孔,强化外部可见极性防呆标识 | 交付打样前清理压焊盘/重叠丝印,提升贴片检验与人工焊接可读性 |
  153. </details>
  154. <details>
  155. <summary><strong>第 6 层:电气/几何双引擎审计与视觉核验(4 个)</strong></summary>
  156. | 工具名 | 核心用处 | 典型使用场景 |
  157. | --- | --- | --- |
  158. | `jlc_elec_lint` | 基于官方编译态网表执行 28 条原理图确定性电气硬检(`ELINT-001~028`),输出去重折叠五列摘要与 `uncoveredItems` 盲区声明,0 Blocker 方可解锁转 PCB | 原理图画完后查漏补缺(电源反接、悬空引脚、上拉缺失、耐压/电平不匹配等) |
  159. | `jlc_pcb_drc_and_lint` | 工程原生 DRC 动态驱动 + 18 条 2.5D 计算几何与电磁拓扑硬检(`PLINT-01~18`),内置 EasyEDA `source` 奇偶轮廓自检、敏感焊盘逐层二值判铜、单层禁布区缺口检测及降噪/盲区声明 | 布局布线与铺铜后检查间距、孤岛、热环路、FB 靠近 SW 干扰、2 层板晶振底层误铺铜与立碑风险等 |
  160. | `jlc_validate` | 交付前四合一总门禁:SCH-PCB 同步 + 28 条电气 Linter + 原生 DRC & 18 条 2.5D 几何 Linter + SMT BOM/CPL 可制造性,汇总全链路 `normalizedSummary` 与 `uncoveredItems` | 导出 Gerber/BOM/CPL 投板前的最终一票否决总验收 |
  161. | `jlc_view_capture` | 输出带公制标尺网格与违例高亮的 PNG 视口图,支持与原厂 Datasheet `Layout Example` 左右双图并排比对 | 人工/多模态视觉复核布局美感、走线整洁度及开关电源/芯片原厂布局还原度 |
  162. </details>
  163. ---
  164. ## CLI 与开发验证
  165. ```bash
  166. # 编译与全量回归测试(105 项单测 + 黄金板卡 E2E)
  167. npm run build
  168. npm test
  169. # 交互式全局环境配置 / 打印零 env 注册片段
  170. npm run setup
  171. npm run print-config
  172. # 环境自检、重建 REA 无伪源码索引与零源码审计
  173. node dist/cli.js doctor
  174. node dist/cli.js index --verify-zero-source
  175. # 校验 L3 指纹重绑定状态 / 离线网表审计
  176. node dist/cli.js calibrate-l3
  177. node dist/cli.js lint path/to/netlist.json
  178. ```

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.