jlceda-mcp-server（官方栈迁移版）

嘉立创 EDA MCP Server — 让 AI 编程助手直接操控嘉立创 EDA 专业版的 PCB/原理图自动化工具集。

v1.0 已完整迁移到官方 JLC AI 栈：不再依赖自研 WebSocket 协议与自研插件，改为 Run API Gateway 扩展（EDA 侧）

• easyeda-api-skill Bridge Server（协议侧）。 MCP Server 把每个工具动作编译成 eda.* 官方 API 代码，通过官方 Bridge Server 在 EDA 内执行。

AI IDE ──stdio(MCP)──> mcp-server ──HTTP /execute──> 官方 Bridge Server(49620-49629)
                                                        │ WS /eda（握手 easyeda-bridge）
                                                        ▼
                                               Run API Gateway 扩展 ──> 嘉立创EDA专业版

• MCP server（本仓库）通过 stdio 与 AI IDE 通信；
• 官方 Bridge Server（scripts/bridge-server.mjs，来自 easyeda-api-skill）自动发现/拉起， 监听端口 49620-49629，单例运行；
• Run API Gateway 扩展在嘉立创EDA专业版内自动扫描端口并连接（需在扩展管理器中勾选 允许外部交互），接收 execute 消息以 new AsyncFunction('eda', code) 执行。

• Node.js >= 18（建议 22 LTS）
• 嘉立创EDA专业版 V3.2+
• 在嘉立创EDA中安装官方 Run API Gateway 扩展：
  • 扩展广场：https://jlcext.com/item/oshwhub-official/run-api-gateway
  • 源码：https://github.com/easyeda/eext-run-api-gateway
  • 安装后在 高级 → 扩展管理器 → Run API Gateway → 配置 勾选 允许外部交互
• （可选）官方 easyeda-api skill：https://github.com/easyeda/easyeda-api-skill

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）

在项目目录创建 .mcp.json：

{
  "mcpServers": {
    "jlceda": {
      "command": "node",
      "args": ["<path-to>/jlceda-mcp-server/dist/index.js"],
      "env": {
        "ANTHROPIC_API_KEY": "sk-ant-..."
      }
    }
  }
}

首次使用时先启动 Bridge Server（或让 MCP server 自动拉起），并在嘉立创EDA中确认 Run API Gateway 扩展已连接（顶部菜单出现 API Gateway）。

pcb_get_state / pcb_screenshot / pcb_run_drc / pcb_get_tracks / pcb_get_pads pcb_get_net_primitives / pcb_get_board_info / pcb_get_feature_support / pcb_ping

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_delete_keepout

pcb_get_silkscreens / pcb_move_silkscreen / pcb_auto_silkscreen

pcb_create_diff_pair / pcb_list_diff_pairs / pcb_delete_diff_pair pcb_create_equal_length / pcb_list_equal_lengths / pcb_delete_equal_length

sch_get_state / sch_get_netlist / sch_run_drc / pcb_open_document

pcb_agent — 智能 Agent，自主编排多步操作完成复杂任务

calc_impedance / calc_trace_width

pcb_bridge_status — Bridge Server 健康状态（EDA 连接数/活动窗口） pcb_list_eda_windows — 列出所有已连接 EDA 窗口 pcb_select_eda_window — 选择活动 EDA 窗口（多开时指定目标） pcb_execute_code — 在 EDA 内直接执行任意 eda.* 官方 API 代码（高级/调试）

坐标单位均为 mil。pcb_execute_code 与官方 easyeda-api-skill 用法一致： 代码以 return await eda.dmt_Project.getCurrentProjectInfo(); 形式返回结果。

pcb_bom_export — 导出 PCB BOM（JSON + CSV，按元件名聚合数量/位号/网络） pcb_net_connectivity_check — 网络连通性检查（标记未布线/单焊盘网络） pcb_current_density_report — 各网络载流能力估算（IPC-2221），标记偏低网络 pcb_fanout_component — 为指定元件所有焊盘创建扇出过孔 pcb_auto_route_nets — 基础自动布线（L 型两层：顶层水平+底层垂直+过孔，需 DRC 复查） pcb_drc_autofix — DRC 自修复（当前支持丝印冲突自动排列），返回修复前后对比

pcb_component_clearance_check — 元件两两间距检查，标记低于阈值的违规对 pcb_route_differential_pairs — 差分对自动布线（正/负网络平行 L 型，报告等长偏差） pcb_design_health_report — 一键设计健康报告（BOM+连通性+载流+DRC+间距，READY/NEEDS_WORK/POOR 评分） pcb_auto_fanout_and_route — 流水线：全部元件扇出 → 全部网络自动布线 → DRC → 丝印自修复

pcb_auto_place_components — 自动布局：元件移动到焊盘质心（一阶优化） pcb_netlist_report — 从 PCB 焊盘生成网表报告（元件→引脚→网络 / 网络→元件） pcb_design_snapshot / pcb_design_diff — 设计快照与差异对比（新增/移除/移动） pcb_auto_route_nets 升级 — 单层障碍规避布线（绕开焊盘+clearance）或两层 L 型（useVias） pcb_bom_export 升级 — 支持 lcscCodes 料号映射（LCSC API 受保护无法自动查询）

sch_generate_from_netlist — 通过官方 sch_Netlist.setNetlist 导入网表生成原理图（EasyEDA/JLCEDA/Protel2/PADS/Allegro/DISA/DSNET） sch_generate_from_pcb — 一键：PCB 网表报告 → Protel2 网表 → 导入原理图生成 pcb_eprj3_project_info — .eprj3 工程检查器（目录/文件：索引、原理图/PCB/面板清单、源文件记录统计）

├── src/
│   ├── index.ts            # MCP 入口（stdio）
│   ├── gateway-client.ts   # 官方 Bridge Server HTTP 客户端（发现/拉起/execute）
│   ├── bridge-client.ts    # 工具层接口（command(action, params)），基于 gateway-client
│   ├── codegen.ts          # 动作 → eda 代码编译（含 ping/select/delete 内联实现）
│   ├── codegen/generated.ts# 自动生成：32 个经典动作的代码模板（npm run port）
│   ├── agent.ts            # pcb_agent（Anthropic tool-use 循环）
│   ├── calculators.ts      # 阻抗/线宽计算
│   └── tools/              # 工具注册（state/components/routing/copper/silkscreen/advanced/schematic/gateway...）
├── scripts/
│   ├── bridge-server.mjs   # 官方 Bridge Server（vendored from easyeda/easyeda-api-skill）
│   ├── port-plugin.mjs     # legacy 插件 → codegen 模板移植工具
│   └── smoke-bridge.mjs    # 端到端协议冒烟测试（mock EDA，无需真实 EDA）
├── legacy-jlc-bridge/      # v0.1 自研插件（已弃用，仅存档）
└── package.json

npm run build
npm run test:bridge   # 75 项协议级断言（无需 EDA）

• EDA 侧：自研 jlc-bridge 插件 → 官方 Run API Gateway 扩展（无需维护插件代码）
• 协议侧：自研 ws://127.0.0.1:18800/ws/bridge → 官方 Bridge Server（49620-49629，握手校验）
• 工具侧：35 个动作处理器原样移植为官方 eda.* 代码模板（scripts/port-plugin.mjs 生成）， MCP 工具接口与 v0.1 完全兼容
• 新增：pcb_bridge_status / pcb_list_eda_windows / pcb_select_eda_window / pcb_execute_code

MIT