Cursor-嘉立创EDA-Bridge使用指南
Cursor 使用嘉立创EDA Bridge 操作指南
本文介绍如何在 Cursor 中通过 jlcmcp + JLC Bridge 扩展,让 AI 直接读写、布局、布线你的嘉立创EDA专业版 PCB 工程。
一、整体架构
Cursor (AI)
│ stdio
▼
jlcmcp MCP Server ← 安装在本地,提供 pcb_* 工具
│ WebSocket
▼
relay.js 中继服务 ← 本机 127.0.0.1:18800
│ WebSocket
▼
JLC Bridge 扩展 ← 运行在嘉立创EDA 专业版内部
│
▼
嘉立创EDA 专业版 PCB 编辑器
三个组件缺一不可:
| 组件 | 作用 |
|---|---|
jlcmcp MCP Server |
把 PCB 操作封装成 Cursor 可调用的 MCP 工具 |
relay.js |
在 MCP 与 EDA 扩展之间转发 WebSocket 消息 |
jlc-bridge.eext |
在 EDA 内部执行移动元件、画走线、DRC 等实际操作 |
注意: 官方 README 里写的「OpenClaw gateway」并不是必需组件。实际可用的是一个约 70 行的
relay.js中继脚本。
二、环境要求
- 操作系统: Windows 10/11
- Node.js: ≥ 18(需加入 PATH,或记下完整路径)
- 嘉立创EDA 专业版: 已安装(示例路径:
C:\Program Files\lceda-pro\lceda-pro.exe) - Cursor: 已安装并支持 MCP
三、安装步骤
3.1 下载 jlcmcp
从 GitHub 获取源码:
若未安装 Git,可用浏览器下载 ZIP 并解压,例如解压到:
C:\Users\你的用户名\Desktop\新建文件夹\jlcmcp
3.2 构建 MCP Server
在 PowerShell 中执行:
cd "C:\Users\你的用户名\Desktop\新建文件夹\jlcmcp"
npm install
npm run build
构建成功后应生成:jlcmcp\dist\index.js
3.3 构建 JLC Bridge 扩展
cd "C:\Users\你的用户名\Desktop\新建文件夹\jlcmcp\jlc-bridge"
npm install
npm run build
构建成功后应生成:
jlcmcp\jlc-bridge\build\jlc-bridge.eext
3.4 配置 Cursor MCP
编辑 Cursor 全局 MCP 配置文件:
C:\Users\你的用户名\.cursor\mcp.json
写入以下内容(请按实际路径修改):
{
"mcpServers": {
"jlceda": {
"command": "C:\\Program Files\\nodejs\\node.exe",
"args": [
"C:\\Users\\你的用户名\\Desktop\\新建文件夹\\jlcmcp\\dist\\index.js"
],
"env": {
"GATEWAY_WS_URL": "ws://127.0.0.1:18800/ws/bridge"
}
}
}
}
保存后 完全重启 Cursor,MCP 才会加载 jlceda 服务。
3.5 安装 EDA 扩展
- 打开 嘉立创EDA 专业版
- 打开你的 PCB 工程,进入 PCB 编辑页
- 菜单:高级 → 扩展管理器
- 点击 导入扩展
- 选择文件:
jlcmcp\jlc-bridge\build\jlc-bridge.eext - 在扩展详情中勾选 「允许外部交互」(WebSocket 必需)
3.6 启动 relay 中继
每次使用前需保持 relay 运行。可用项目目录下的脚本:
C:\Users\你的用户名\Desktop\新建文件夹\start-jlc-relay.ps1
或手动执行:
node "C:\Users\你的用户名\Desktop\新建文件夹\jlcmcp\relay.js"
看到以下输出表示成功:
relay listening on ws://127.0.0.1:18800/ws/bridge
classifies by first msg: bridge=hello, mcp=command
relay 窗口需保持打开,关闭后 Cursor 将无法连接 EDA。
四、启用 Bridge 并验证连接
4.1 在 EDA 中启用 Bridge
- 确认当前在 PCB 页(原理图页部分工具不可用)
- 顶部菜单:JLC Bridge → Enable/Disable Bridge
- 再点 JLC Bridge → Status
正常状态应显示:
Runtime: running
Transport: WebSocket
WS: connected
若显示 file polling 或 WS: disconnected,说明 WebSocket 未连通,请检查:
- relay 是否在运行
- 扩展是否勾选 允许外部交互
- 关闭 Bridge 后重新启用
4.2 在 Cursor 中验证
重启 Cursor 后,在 Agent 对话中输入:
用 jlceda 执行 pcb_ping,检查连接
成功时返回类似:
{ "message": "pong", "timestamp": ... }
也可输入:
获取当前 PCB 状态
AI 会自动调用 pcb_get_state 并返回元件、网络等信息。
4.3 在 Cursor 里哪里看到 jlceda?
jlceda 不会出现在聊天框旁的按钮里,它是后台 MCP 工具。
查看方式:
Ctrl + ,打开设置- 搜索 MCP 或进入 Features → MCP
- 应看到
jlceda服务(绿点 = 已连接)
五、日常使用流程
每次开始 PCB 辅助工作,按此顺序操作:
① 启动 relay(start-jlc-relay.ps1)
② 打开嘉立创EDA → 打开工程 → 进入 PCB 页
③ 启用 JLC Bridge(Status 显示 WebSocket + connected)
④ 打开 Cursor → 在对话中描述需求
5.1 示例对话
| 你说的话 | AI 调用的工具 |
|---|---|
| 获取当前 PCB 状态 | pcb_get_state |
| 检查连接 | pcb_ping |
| 运行 DRC | pcb_run_drc |
| 把 U1 移到 (1000, 2000) | pcb_move_component |
| 在 GND 网络画一条走线 | pcb_route_track |
| 列出未布线网络 | pcb_get_state / pcb_get_net_primitives |
| 截取 PCB 截图 | pcb_screenshot |
5.2 坐标与线宽单位
所有坐标、线宽单位为 mil(密耳),与嘉立创EDA Bridge API 一致。
示例:画 8 mil 宽走线
{
"net": "GND",
"layer": 1,
"width": 8,
"points": [
{ "x": 5000, "y": -4000 },
{ "x": 5200, "y": -3800 }
]
}
layer: 1= 顶层layer: 2= 底层(双层板)
六、可用 MCP 工具一览
状态查询
| 工具 | 说明 |
|---|---|
pcb_ping |
检查 Bridge 连接 |
pcb_get_state |
获取 PCB 完整状态(元件、网络、板框) |
pcb_get_board_info |
获取工程信息 |
pcb_get_tracks |
查询走线(可按网络/层过滤) |
pcb_get_pads |
查询焊盘 |
pcb_get_net_primitives |
查询指定网络的所有图元 |
pcb_screenshot |
截取编辑器截图 |
pcb_run_drc |
运行设计规则检查 |
pcb_get_feature_support |
查询 Bridge 支持的功能 |
元件操作
| 工具 | 说明 |
|---|---|
pcb_move_component |
移动元件 |
pcb_relocate_component |
安全搬迁元件(自动断开相连走线) |
pcb_batch_move |
批量移动 |
pcb_select_component |
选中元件 |
pcb_delete_selected |
删除选中对象 |
pcb_create_component |
从库放置元件 |
走线 / 过孔
| 工具 | 说明 |
|---|---|
pcb_route_track |
画走线 |
pcb_create_via |
创建过孔 |
pcb_delete_tracks |
删除走线 |
pcb_delete_via |
删除过孔 |
铺铜 / 禁布区 / 丝印 / 高级约束
| 工具 | 说明 |
|---|---|
pcb_create_copper_pour |
创建矩形铺铜 |
pcb_delete_pour |
删除铺铜 |
pcb_create_keepout |
创建禁布区 |
pcb_get_silkscreens / pcb_move_silkscreen |
丝印查询与移动 |
pcb_create_diff_pair |
创建差分对 |
pcb_create_equal_length |
创建等长组 |
计算工具
| 工具 | 说明 |
|---|---|
calc_trace_width |
按载流计算线宽(IPC-2221) |
calc_impedance |
计算/反算阻抗 |
七、relay 日志判读
relay 窗口中的关键日志:
role=bridge JLC Bridge v0.1.13 ← EDA 扩展已连接
role=mcp ← Cursor MCP 已连接
mcp -> bridge: ping ← 命令发出
bridge -> mcp: result ... success=true ← 执行成功
mcp -> bridge: bridge not connected ← EDA 未连接
八、常见问题
Q1:MCP 显示 bridge not connected
原因: EDA 扩展未通过 WebSocket 连上 relay。
处理:
- 确认 relay 正在运行
- EDA 扩展管理器中勾选 允许外部交互
- 在 PCB 页:JLC Bridge → 先关闭再开启
- Status 中确认
Transport: WebSocket、WS: connected
Q2:显示 file polling 而不是 WebSocket
原因: 未开启外部交互权限,Bridge 退回到文件轮询模式,Cursor MCP 无法通过该模式工作。
处理: 重新导入扩展并勾选「允许外部交互」,然后重启 Bridge。
Q3:Cursor 里看不到 jlceda 工具
处理:
- 检查
C:\Users\你的用户名\.cursor\mcp.json路径是否正确 - 确认
jlcmcp\dist\index.js已构建 - 完全退出并重启 Cursor(不是只关窗口)
Q4:端口 18800 被占用
netstat -ano | findstr 18800
结束占用进程后重新运行 start-jlc-relay.ps1。
Q5:AI 布的线出现直角或元件重叠
Bridge 的 pcb_route_track 按 点序列 生成线段。若只给水平/垂直转折点,就会得到直角走线。
建议:
- 在对话中明确要求:「使用 45° 斜线,不要直角」
- 元件重叠时,让 AI 先用
pcb_relocate_component调整位置再布线 - 布完后用
pcb_run_drc检查间距与重叠
Q6:每次开机都要重新配置吗?
需要每次手动启动 relay 和 EDA Bridge。MCP 配置(mcp.json)和扩展安装是一次性的。
九、推荐项目目录结构
你的工程目录/
├── V2控制板.eprj2 # 嘉立创EDA 工程
├── jlcmcp/ # MCP + Bridge 源码
│ ├── dist/index.js # MCP Server 入口
│ ├── relay.js # WebSocket 中继
│ └── jlc-bridge/build/
│ └── jlc-bridge.eext # EDA 扩展包
├── start-jlc-relay.ps1 # 一键启动 relay
└── Cursor-嘉立创EDA-Bridge使用指南.md
十、安全提示
- relay 仅监听
127.0.0.1,不要暴露到局域网 - Bridge 扩展拥有读写 PCB 的权限,AI 操作前建议 备份工程
- 大批量自动布线后务必人工复查 + DRC
十一、参考链接
- jlcmcp 仓库:https://github.com/hyl64/jlcmcp
- 嘉立创EDA 扩展 API 文档:https://prodocs.lceda.cn/cn/api/guide/invoke-apis.html
- MCP 协议:https://modelcontextprotocol.io/
文档基于 Cursor + 嘉立创EDA专业版 v3.2 + jlcmcp 实际配置过程整理。

浙公网安备 33010602011771号