Jlcmcp

jlceda-mcp-server

本项目上传的文件完全由opus4.6完成，有问题请问agent

嘉立创 EDA MCP Server — 让 AI 编程助手直接操控嘉立创 EDA 的 PCB 自动化工具集。

通过 Model Context Protocol 暴露 39 个 PCB/原理图工具，在 Claude Code / Cursor / Windsurf 等 AI IDE 中直接执行元件移动、走线、铺铜、DRC 等操作。内置 PCB Agent 可自主编排多步操作完成复杂任务。

架构

AI IDE ──stdio──> mcp-server ──WebSocket──> gateway ──> jlc-bridge 插件 ──> 嘉立创 EDA

MCP server 通过 stdio 与 AI IDE 通信，内部维护 WebSocket 连接到 gateway 的 /ws/bridge 端点，转发命令给 jlc-bridge 插件控制 EDA 编辑器。

本仓库包含两个组件：

• src/ — MCP Server（Node.js，39 个 PCB/原理图工具 + Agent）
• jlc-bridge/ — 嘉立创 EDA 扩展插件（运行在 EDA 内部，执行实际操作）

前置条件

• Node.js >= 18
• gateway 运行中（默认端口 18800）
• jlc-bridge 插件已连接嘉立创 EDA

安装 & 构建

npm install
npm run build

配置

在你的项目目录下创建 .mcp.json：

{
  "mcpServers": {
    "jlceda": {
      "command": "node",
      "args": ["/jlceda-mcp-server/dist/index.js"],
      "env": {
        "GATEWAY_WS_URL": "ws://127.0.0.1:18800/ws/bridge",
        "ANTHROPIC_API_KEY": "sk-ant-..."
      }
    }
  }
}

配置完成后重启 AI IDE，即可在对话中使用所有工具。

环境变量

| 变量 | 默认值 | 说明 | |------|--------|------| | GATEWAY_WS_URL | ws://127.0.0.1:18800/ws/bridge | Gateway WebSocket 地址 | | ANTHROPIC_API_KEY | — | Anthropic API Key（设置后启用 pcb_agent 工具） | | AGENT_MODEL | claude-sonnet-4-20250514 | Agent 使用的模型 |

工具清单 (39 个)

状态查询 (9)

| 工具 | 说明 | |------|------| | pcb_get_state | 获取 PCB 完整状态（元件、网络、板框） | | pcb_screenshot | 截取编辑器截图（base64 PNG） | | pcb_run_drc | 运行 PCB 设计规则检查 | | pcb_get_tracks | 查询走线段，可按网络/层过滤 | | pcb_get_pads | 查询焊盘信息，可按位号过滤 | | pcb_get_net_primitives | 查询指定网络的所有图元 | | pcb_get_board_info | 获取工程信息 | | pcb_get_feature_support | 查询 bridge 支持的功能列表 | | pcb_ping | 检查 bridge 连接状态 |

元件操作 (6)

| 工具 | 说明 | |------|------| | pcb_move_component | 移动元件到指定坐标 | | pcb_relocate_component | 安全搬迁元件（自动断开走线） | | pcb_batch_move | 批量移动多个元件 | | pcb_select_component | 在编辑器中选中元件 | | pcb_delete_selected | 删除当前选中的对象 | | pcb_create_component | 从库中放置元件到 PCB |

走线 / 过孔 (4)

| 工具 | 说明 | |------|------| | pcb_route_track | 画走线（指定网络、路径点、层、线宽） | | pcb_create_via | 创建过孔 | | pcb_delete_tracks | 删除走线 | | pcb_delete_via | 删除过孔 |

铺铜 / 禁布区 (4)

| 工具 | 说明 | |------|------| | pcb_create_copper_pour | 创建矩形铺铜区域 | | pcb_delete_pour | 删除铺铜 | | pcb_create_keepout | 创建矩形禁布区 | | pcb_delete_keepout | 删除禁布区 |

丝印 (3)

| 工具 | 说明 | |------|------| | pcb_get_silkscreens | 查询所有丝印文字 | | pcb_move_silkscreen | 移动丝印 | | pcb_auto_silkscreen | 自动排列丝印（避免重叠） |

高级约束 (6)

| 工具 | 说明 | |------|------| | pcb_create_diff_pair | 创建差分对 | | pcb_list_diff_pairs | 列出所有差分对 | | pcb_delete_diff_pair | 删除差分对 | | pcb_create_equal_length | 创建等长组 | | pcb_list_equal_lengths | 列出所有等长组 | | pcb_delete_equal_length | 删除等长组 |

原理图 / 文档 (4)

| 工具 | 说明 | |------|------| | sch_get_state | 读取原理图状态 | | sch_get_netlist | 导出网表 | | sch_run_drc | 运行原理图 DRC | | pcb_open_document | 切换到指定文档（原理图或 PCB） |

PCB Agent (1)

| 工具 | 说明 | |------|------| | pcb_agent | 智能 Agent — 给出高层任务，自主编排多步操作完成（需 ANTHROPICAPIKEY） |

计算工具 (2)

| 工具 | 说明 | |------|------| | calc_impedance | 计算走线阻抗，或根据目标阻抗反算线宽（微带线/带状线/差分） | | calc_trace_width | 根据载流要求计算最小走线宽度 (IPC-2221) |

> 所有坐标参数单位为 mil（密耳），与嘉立创 EDA bridge 一致。

项目结构

├── src/                          # MCP Server 源码
│   ├── index.ts                  # MCP 入口（stdio transport）
│   ├── bridge-client.ts          # WebSocket 客户端，连接 gateway bridge
│   ├── calculators.ts            # 阻抗/线宽纯计算函数
│   ├── agent.ts                  # PCB Agent 核心（工具注册表 + tool-use 循环）
│   └── tools/
│       ├── state.ts              # 状态查询 (7)
│       ├── components.ts         # 元件操作 (3)
│       ├── routing.ts            # 走线/过孔 (4)
│       ├── copper-keepout.ts     # 铺铜/禁布区 (4)
│       ├── silkscreen.ts         # 丝印 (3)
│       ├── advanced.ts           # 差分对/等长组 (4)
│       ├── schematic.ts          # 原理图 (3)
│       ├── calculators.ts        # 阻抗/线宽计算工具 (2)
│       └── agent.ts              # PCB Agent 工具注册 (1)
├── jlc-bridge/                   # 嘉立创 EDA 扩展插件
│   ├── src/index.ts              # 插件主入口（2700+ 行）
│   ├── extension.json            # 插件清单
│   ├── build/pack.js             # 打包脚本（生成 .eext/.lcex）
│   ├── package.json
│   └── tsconfig.json
├── dist/                         # MCP Server 编译输出
├── package.json
└── tsconfig.json

核心模块

bridge-client.ts

WebSocket 客户端，连接 gateway /ws/bridge。

• 协议：发送 {type:'command', id, timestamp, payload:{action, params}}，接收 {type:'result', payload:{commandId, success, data, error}}
• 命令超时 60 秒
• 断线自动重连（3 秒间隔）
• 懒连接：首次调用 command() 时才建立 WebSocket

agent.ts

PCB 智能 Agent 核心，基于 Anthropic Claude API 的 tool-use 循环。

• 工具注册表：将 28 个 bridge 动作映射为 Anthropic tool-use 格式
• Agent 循环：system prompt → messages.create → 执行 tooluse → 追加 toolresult → 继续循环
• 最大轮次限制（默认 20），防止无限循环
• 收集每步执行日志，最终一起返回
• 零额外基础设施，纯 @anthropic-ai/sdk 实现

jlc-bridge 插件

运行在嘉立创 EDA 内部的扩展插件，负责执行实际的 PCB/原理图操作。

• 通过 WebSocket 连接 gateway，接收并执行命令
• 支持文件轮询回退（当 WebSocket 不可用时）
• 50+ 个底层操作函数（元件移动、走线、铺铜、DRC 等）
• 打包为 .eext / .lcex 格式，在嘉立创 EDA 扩展管理器中安装

构建插件：

cd jlc-bridge
npm install
npm run build    # 编译 + 打包为 .eext

使用示例

在 AI IDE 中直接用自然语言：

> 获取当前 PCB 状态
  → 调用 pcb_get_state

> 把 U1 移到 (1000, 2000)
  → 调用 pcb_move_component {designator:"U1", x:1000, y:2000}

> 运行 DRC 检查
  → 调用 pcb_run_drc

> 在 GND 网络顶层铺铜，范围 (0,0) 到 (2000,4000)
  → 调用 pcb_create_copper_pour {net:"GND", layer:1, x1:0, y1:0, x2:2000, y2:4000}

> 创建 USB 差分对
  → 调用 pcb_create_diff_pair {name:"USB", posNet:"USB_DP", negNet:"USB_DN"}

> 分析当前布局并给出优化建议
  → 调用 pcb_agent {task:"分析当前布局并给出优化建议"}
  → Agent 自主调用 get_state → 分析 → 给出建议

验证

# 编译
npm run build

# 测试 MCP 协议（不需要 gateway）
echo '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}},"id":0}
{"jsonrpc":"2.0","method":"tools/list","id":1}' | node dist/index.js

# 端到端测试（需要 gateway + jlc-bridge 运行）
# 在 AI IDE 中说 "获取当前 PCB 状态" 即可验证

技术栈

• TypeScript 5.7, ES2022 modules
• @modelcontextprotocol/sdk ^1.12 — MCP 协议实现
• @anthropic-ai/sdk ^0.39 — Claude API（Agent tool-use 循环）
• ws ^8 — WebSocket 客户端
• zod ^3.23 — 工具参数 schema 定义

License

MIT

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: hyl64
• Source: hyl64/jlcmcp
• License: MIT

Install and usage instructions live in the source repository linked above.