Skip to content
Back to search

jlcmcp

嘉立创 EDA MCP Server(官方栈版)— 59 个工具:PCB/原理图自动化 + 自动布局/布线/DRC自修复/设计健康报告 等高级功能,基于官方 Run API Gateway + easyeda-api-skill

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/hyl64--jlcmcp/badge.svg)](/listings/hyl64--jlcmcp)

HTML

<a href="/listings/hyl64--jlcmcp"><img src="/api/listings/hyl64--jlcmcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npm install
npm run build        # tsc 编译
npm run port         # (可选)从 legacy-jlc-bridge 重新生成代码模板
npm run start:bridge # (可选)手动启动官方 Bridge Server;MCP server 也会自动拉起
npm run test:bridge  # 端到端协议冒烟测试(无需真实 EDA,内置 mock)

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 · 181 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # jlceda-mcp-server(官方栈迁移版)
  2. 嘉立创 EDA MCP Server — 让 AI 编程助手直接操控嘉立创 EDA 专业版的 PCB/原理图自动化工具集。
  3. **v1.0 已完整迁移到官方 JLC AI 栈**:不再依赖自研 WebSocket 协议与自研插件,改为
  4. [Run API Gateway 扩展](https://github.com/easyeda/eext-run-api-gateway)(EDA 侧)
  5. + [easyeda-api-skill](https://github.com/easyeda/easyeda-api-skill) Bridge Server(协议侧)。
  6. MCP Server 把每个工具动作编译成 eda.* 官方 API 代码,通过官方 Bridge Server 在 EDA 内执行。
  7. ## 架构
  8. ```
  9. AI IDE ──stdio(MCP)──> mcp-server ──HTTP /execute──> 官方 Bridge Server(49620-49629)
  10. │ WS /eda(握手 easyeda-bridge)
  11. ▼
  12. Run API Gateway 扩展 ──> 嘉立创EDA专业版
  13. ```
  14. - MCP server(本仓库)通过 stdio 与 AI IDE 通信;
  15. - 官方 Bridge Server(scripts/bridge-server.mjs,来自 easyeda-api-skill)自动发现/拉起,
  16. 监听端口 49620-49629,单例运行;
  17. - Run API Gateway 扩展在嘉立创EDA专业版内自动扫描端口并连接(需在扩展管理器中勾选
  18. **允许外部交互**),接收 execute 消息以 new AsyncFunction('eda', code) 执行。
  19. ## 前置条件
  20. - Node.js >= 18(建议 22 LTS)
  21. - 嘉立创EDA专业版 V3.2+
  22. - 在嘉立创EDA中安装官方 **Run API Gateway** 扩展:
  23. - 扩展广场:https://jlcext.com/item/oshwhub-official/run-api-gateway
  24. - 源码:https://github.com/easyeda/eext-run-api-gateway
  25. - 安装后在 高级 → 扩展管理器 → Run API Gateway → 配置 勾选 **允许外部交互**
  26. - (可选)官方 easyeda-api skill:https://github.com/easyeda/easyeda-api-skill
  27. ## 安装 & 构建
  28. ```bash
  29. npm install
  30. npm run build # tsc 编译
  31. npm run port # (可选)从 legacy-jlc-bridge 重新生成代码模板
  32. npm run start:bridge # (可选)手动启动官方 Bridge Server;MCP server 也会自动拉起
  33. npm run test:bridge # 端到端协议冒烟测试(无需真实 EDA,内置 mock)
  34. ```
  35. ## 配置
  36. 在项目目录创建 .mcp.json:
  37. ```json
  38. {
  39. "mcpServers": {
  40. "jlceda": {
  41. "command": "node",
  42. "args": ["<path-to>/jlceda-mcp-server/dist/index.js"],
  43. "env": {
  44. "ANTHROPIC_API_KEY": "sk-ant-..."
  45. }
  46. }
  47. }
  48. }
  49. ```
  50. 首次使用时先启动 Bridge Server(或让 MCP server 自动拉起),并在嘉立创EDA中确认
  51. Run API Gateway 扩展已连接(顶部菜单出现 **API Gateway**)。
  52. ## 环境变量
  53. | 变量 | 默认值 | 说明 |
  54. |------|--------|------|
  55. | GATEWAY_BASE_URL | 自动扫描 | 显式指定官方 Bridge Server 地址(如 http://127.0.0.1:49620) |
  56. | AUTO_SPAWN_BRIDGE | true | 未发现 Bridge Server 时自动拉起 scripts/bridge-server.mjs |
  57. | BRIDGE_SERVER_PATH | scripts/bridge-server.mjs | 自定义 Bridge Server 路径 |
  58. | KILL_BRIDGE_ON_EXIT | 0 | 退出时是否结束自拉起的 Bridge Server(官方单例共享,默认不结束) |
  59. | ANTHROPIC_API_KEY | — | Anthropic API Key(设置后启用 pcb_agent 工具) |
  60. | AGENT_MODEL | claude-sonnet-4-20250514 | Agent 使用的模型 |
  61. ## 工具清单(59 个)
  62. ### 状态查询 (9)
  63. pcb_get_state / pcb_screenshot / pcb_run_drc / pcb_get_tracks / pcb_get_pads
  64. pcb_get_net_primitives / pcb_get_board_info / pcb_get_feature_support / pcb_ping
  65. ### 元件操作 (6)
  66. pcb_move_component / pcb_relocate_component / pcb_batch_move / pcb_select_component
  67. pcb_delete_selected / pcb_create_component
  68. ### 走线 / 过孔 (4)
  69. pcb_route_track / pcb_create_via / pcb_delete_tracks / pcb_delete_via
  70. ### 铺铜 / 禁布区 (4)
  71. pcb_create_copper_pour / pcb_delete_pour / pcb_create_keepout / pcb_delete_keepout
  72. ### 丝印 (3)
  73. pcb_get_silkscreens / pcb_move_silkscreen / pcb_auto_silkscreen
  74. ### 高级约束 (6)
  75. pcb_create_diff_pair / pcb_list_diff_pairs / pcb_delete_diff_pair
  76. pcb_create_equal_length / pcb_list_equal_lengths / pcb_delete_equal_length
  77. ### 原理图 / 文档 (4)
  78. sch_get_state / sch_get_netlist / sch_run_drc / pcb_open_document
  79. ### PCB Agent (1,需 ANTHROPIC_API_KEY)
  80. pcb_agent — 智能 Agent,自主编排多步操作完成复杂任务
  81. ### 计算工具 (2)
  82. calc_impedance / calc_trace_width
  83. ### 官方 Bridge 运维 (4,v1.0 新增)
  84. pcb_bridge_status — Bridge Server 健康状态(EDA 连接数/活动窗口)
  85. pcb_list_eda_windows — 列出所有已连接 EDA 窗口
  86. pcb_select_eda_window — 选择活动 EDA 窗口(多开时指定目标)
  87. pcb_execute_code — 在 EDA 内直接执行任意 eda.* 官方 API 代码(高级/调试)
  88. > 坐标单位均为 mil。pcb_execute_code 与官方 easyeda-api-skill 用法一致:
  89. > 代码以 return await eda.dmt_Project.getCurrentProjectInfo(); 形式返回结果。
  90. ### 高级功能 (6,v1.1 新增)
  91. pcb_bom_export — 导出 PCB BOM(JSON + CSV,按元件名聚合数量/位号/网络)
  92. pcb_net_connectivity_check — 网络连通性检查(标记未布线/单焊盘网络)
  93. pcb_current_density_report — 各网络载流能力估算(IPC-2221),标记偏低网络
  94. pcb_fanout_component — 为指定元件所有焊盘创建扇出过孔
  95. pcb_auto_route_nets — 基础自动布线(L 型两层:顶层水平+底层垂直+过孔,需 DRC 复查)
  96. pcb_drc_autofix — DRC 自修复(当前支持丝印冲突自动排列),返回修复前后对比
  97. ### 高级功能 v2 (4,v1.2 新增)
  98. pcb_component_clearance_check — 元件两两间距检查,标记低于阈值的违规对
  99. pcb_route_differential_pairs — 差分对自动布线(正/负网络平行 L 型,报告等长偏差)
  100. pcb_design_health_report — 一键设计健康报告(BOM+连通性+载流+DRC+间距,READY/NEEDS_WORK/POOR 评分)
  101. pcb_auto_fanout_and_route — 流水线:全部元件扇出 → 全部网络自动布线 → DRC → 丝印自修复
  102. ### 高级功能 v3 (4,v1.3 新增)
  103. pcb_auto_place_components — 自动布局:元件移动到焊盘质心(一阶优化)
  104. pcb_netlist_report — 从 PCB 焊盘生成网表报告(元件→引脚→网络 / 网络→元件)
  105. pcb_design_snapshot / pcb_design_diff — 设计快照与差异对比(新增/移除/移动)
  106. pcb_auto_route_nets 升级 — 单层障碍规避布线(绕开焊盘+clearance)或两层 L 型(useVias)
  107. pcb_bom_export 升级 — 支持 lcscCodes 料号映射(LCSC API 受保护无法自动查询)
  108. ### 高级功能 v4 (3,v1.4 新增)
  109. sch_generate_from_netlist — 通过官方 sch_Netlist.setNetlist 导入网表生成原理图(EasyEDA/JLCEDA/Protel2/PADS/Allegro/DISA/DSNET)
  110. sch_generate_from_pcb — 一键:PCB 网表报告 → Protel2 网表 → 导入原理图生成
  111. pcb_eprj3_project_info — .eprj3 工程检查器(目录/文件:索引、原理图/PCB/面板清单、源文件记录统计)
  112. ## 项目结构
  113. ```
  114. ├── src/
  115. │ ├── index.ts # MCP 入口(stdio)
  116. │ ├── gateway-client.ts # 官方 Bridge Server HTTP 客户端(发现/拉起/execute)
  117. │ ├── bridge-client.ts # 工具层接口(command(action, params)),基于 gateway-client
  118. │ ├── codegen.ts # 动作 → eda 代码编译(含 ping/select/delete 内联实现)
  119. │ ├── codegen/generated.ts# 自动生成:32 个经典动作的代码模板(npm run port)
  120. │ ├── agent.ts # pcb_agent(Anthropic tool-use 循环)
  121. │ ├── calculators.ts # 阻抗/线宽计算
  122. │ └── tools/ # 工具注册(state/components/routing/copper/silkscreen/advanced/schematic/gateway...)
  123. ├── scripts/
  124. │ ├── bridge-server.mjs # 官方 Bridge Server(vendored from easyeda/easyeda-api-skill)
  125. │ ├── port-plugin.mjs # legacy 插件 → codegen 模板移植工具
  126. │ └── smoke-bridge.mjs # 端到端协议冒烟测试(mock EDA,无需真实 EDA)
  127. ├── legacy-jlc-bridge/ # v0.1 自研插件(已弃用,仅存档)
  128. └── package.json
  129. ```
  130. ## 验证
  131. ```bash
  132. npm run build
  133. npm run test:bridge # 75 项协议级断言(无需 EDA)
  134. ```
  135. ## 迁移说明(v0.1 → v1.0)
  136. - EDA 侧:自研 jlc-bridge 插件 → 官方 **Run API Gateway** 扩展(无需维护插件代码)
  137. - 协议侧:自研 ws://127.0.0.1:18800/ws/bridge → 官方 Bridge Server(49620-49629,握手校验)
  138. - 工具侧:35 个动作处理器原样移植为官方 eda.* 代码模板(scripts/port-plugin.mjs 生成),
  139. MCP 工具接口与 v0.1 完全兼容
  140. - 新增:pcb_bridge_status / pcb_list_eda_windows / pcb_select_eda_window / pcb_execute_code
  141. ## License
  142. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

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