JLCEDA MCP 是一套面向嘉立创 EDA 的本地 MCP 双扩展方案，由 mcp-hub 和 mcp-bridge 组成。接入后，你可以直接在 Copilot、Cursor Chat 中检查原理图、分析电路、辅助设计电路方案，并让 AI 在嘉立创 EDA 中完成相关操作。
嘉立创 EDA（mcp-bridge）
↕ WebSocket 桥接
VS Code / Cursor（mcp-hub）
↕ stdio/http MCP 协议
MCP 客户端（Copilot / Cursor Chat / Claude Code / Codex 等）
- mcp-bridge：EDA 侧扩展，建立到 mcp-hub 的 WebSocket 连接，负责让 AI 在嘉立创 EDA 中读取当前图纸信息并执行相关操作。
- mcp-hub：VS Code/Cursor 侧扩展，通过 stdio/http MCP 协议将多项 MCP 工具能力暴露给 AI 助手，并托管桥接 WebSocket 服务接收 Bridge 连接。
基础工具
| 工具 | 说明 |
|---|---|
schematic_read |
读取当前原理图的完整电路语义快照，返回器件列表、引脚→网络名映射、网络连接关系与 DRC 检查结果 |
schematic_review |
读取全工程所有原理图页面的网表文件，覆盖多页电路，适合全局审查、BOM 核查与跨页信号追踪 |
pcb_snapshot |
读取当前 PCB 页面归一化后的几何关系快照，返回图层、走线、过孔、覆铜、fill、region、image、object、实际覆铜填充区域、器件、焊盘与板框信息 |
pcb_geometry_analyze |
分析当前 PCB 的几何关系，返回规范化 relations、features 与证据字段，支持路由拓扑、参考面连续性、换层回流过孔距离、平面投影 loop area proxy 与 trace/object 空间关系等事实型分析 |
pcb_constraint_snapshot |
读取当前 PCB 的第二层约束与结构上下文快照，返回规则配置、网络规则、差分对、等长组、网络类以及更细的 pad/via 结构细节 |
component_select |
在 EDA 系统库中搜索候选器件，并在 VS Code / Cursor 侧边栏中由用户确认具体型号 |
component_place |
按顺序启动器件交互放置流程，在侧边栏中提示当前进度并等待用户完成放置 |
透传 EDA API 工具（可选）
在 mcp-hub 侧边栏「功能设置」中开启「暴露透传 EDA API 工具」后，以下工具将额外暴露给 AI 客户端，开关切换后立即生效。适合有进阶需求的用户探索使用。
| 工具 | 说明 |
|---|---|
api_index |
列出所有可用的 EDA API 模块名称，用于浏览 API 命名空间全貌 |
api_search |
按关键词搜索具体 API 方法及其参数说明，便于 AI 定位所需接口 |
eda_context |
读取当前 EDA 页面的上下文信息，包括活动页类型与当前工程基本状态 |
api_invoke |
直接调用任意 EDA API 并将结果透传给 AI，适用于核心工具未覆盖的定制化任务 |
- 当 AI 需要先确认器件型号时，会在 VS Code / Cursor 侧边栏弹出器件选型面板，由用户手动确认具体器件。
- 当 AI 需要在原理图中放置器件时，会在侧边栏弹出交互放置面板，按顺序提示当前应放置的器件。
- 在器件选型或器件放置过程中，如果点击取消或跳过，只会跳过当前器件，AI 会继续处理后续器件，不会重试当前项。
- 电源符号和地符号不会由 AI 自动放置，需由用户在嘉立创 EDA 中手动添加。
- 如果启用了“打开 EDA 时关闭侧边栏”，那么打开 EDA 后，以及器件选型或器件放置完成后，侧边栏都会自动收起。
服务端和客户端两个扩展都需要安装。
初次安装时，先确认 VS Code/Cursor 与嘉立创 EDA 两侧扩展都已安装，再检查聊天工具的 MCP 服务配置是否正确。
从扩展商店安装（推荐）：
- VS Code：marketplace.visualstudio.com
- Cursor（Open VSX）：open-vsx.org
从扩展管理器安装（推荐）：
打开嘉立创 EDA，进入扩展管理器，搜索"MCP Bridge"并安装。
- 两个扩展必须同时安装，单独安装任意一侧均无法使用在线调用功能。
- 如果修改了服务端监听端口，需在 EDA Bridge 设置页同步更新桥接地址。
- 首次发起聊天后服务才会启动，且仅在原理图或 PCB 页面可连接。
- 多页面同时连接时，只有活动角色页面执行任务，其余页面处于待命状态，属正常现象。若当前 EDA 页面与活动客户端不一致，请关闭其他 EDA 页面后刷新当前页。
- 状态异常时，先重载 VS Code/Cursor，再重启嘉立创 EDA。
以下内容面向开发者与维护者。
JLCEDA-MCP/
├─ mcp-hub/ VS Code/Cursor 扩展与 stdio MCP 运行时
├─ mcp-bridge/ 嘉立创 EDA 扩展与桥接 WebSocket 客户端
├─ shared/ Hub / Bridge 共用的桥接协议与消息契约
├─ build/ 构建产物输出目录（VSIX / EEXT）
└─ tool/ 离线文档与资源生成辅助脚本
- Node.js 20+
- npm
- VS Code 1.105+（mcp-hub 开发与调试）
- 嘉立创 EDA 专业版（mcp-bridge 安装与联调）
构建 mcp-hub：
cd mcp-hub
npm install
npm run build产物：build/jlceda-mcp-hub-<version>.vsix
构建 mcp-bridge：
cd mcp-bridge
npm install
npm run build产物：build/jlceda-mcp-bridge-<version>.eext
验证 mcp-hub：
cd mcp-hub
npm run test
npm run lint
npm run typecheck验证 mcp-bridge：
cd mcp-bridge
npm run test
npm run lint
npm run typecheckCI 质量门会在 Windows 环境按 test -> lint -> typecheck -> build 顺序校验 mcp-hub 与 mcp-bridge。
- 在 VS Code 或 Cursor 中安装 mcp-hub 扩展。
- 在侧边栏确认桥接监听地址，默认为
ws://127.0.0.1:8765/bridge/ws。 - 在嘉立创 EDA 中安装 mcp-bridge，写入相同的桥接地址。
- 打开 EDA 工程，确认 Bridge 已建立桥接连接。
- 在聊天客户端调用工具，并观察侧边栏状态、连接列表与日志。
- 新增或变更工具定义时，同步更新
mcp-hub/resources/mcp-tool-definitions.json、对应 README 与 CHANGELOG。 - 新增或变更桥接任务路径时，必须同时修改 mcp-hub 与 mcp-bridge 两端处理逻辑。
- 调整桥接地址、端口、协议字段或角色模型时，同步更新相关 README 与 CHANGELOG。
- 发布前执行两端
test、lint、typecheck与build，确认 VSIX 与 EEXT 均可成功生成。 - PCB 几何/约束分析能力通过 bridge plugin 接入；MCP handler 仅负责参数校验与插件分发，新增 PCB 能力时优先扩展插件契约与共享 schema，而不是在 runtime 中直接堆逻辑。
本项目采用 Apache License 2.0 许可证。