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 扩展

  1. 打开 嘉立创EDA 专业版
  2. 打开你的 PCB 工程,进入 PCB 编辑页
  3. 菜单:高级 → 扩展管理器
  4. 点击 导入扩展
  5. 选择文件:jlcmcp\jlc-bridge\build\jlc-bridge.eext
  6. 在扩展详情中勾选 「允许外部交互」(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

  1. 确认当前在 PCB 页(原理图页部分工具不可用)
  2. 顶部菜单:JLC Bridge → Enable/Disable Bridge
  3. 再点 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 工具。

查看方式:

  1. Ctrl + , 打开设置
  2. 搜索 MCP 或进入 Features → MCP
  3. 应看到 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。

处理:

  1. 确认 relay 正在运行
  2. EDA 扩展管理器中勾选 允许外部交互
  3. 在 PCB 页:JLC Bridge → 先关闭再开启
  4. Status 中确认 Transport: WebSocket、WS: connected

Q2:显示 file polling 而不是 WebSocket

原因: 未开启外部交互权限,Bridge 退回到文件轮询模式,Cursor MCP 无法通过该模式工作。

处理: 重新导入扩展并勾选「允许外部交互」,然后重启 Bridge。

Q3:Cursor 里看不到 jlceda 工具

处理:

  1. 检查 C:\Users\你的用户名\.cursor\mcp.json 路径是否正确
  2. 确认 jlcmcp\dist\index.js 已构建
  3. 完全退出并重启 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

十一、参考链接


文档基于 Cursor + 嘉立创EDA专业版 v3.2 + jlcmcp 实际配置过程整理。

posted @ 2026-06-22 17:33  阿坦  阅读(1564)  评论(0)    收藏  举报