jlceda-mcp-server (Offizieller Stack-Migrationszweig)

JialiCAD EDA MCP Server - Lassen Sie KI-Programmierassistenten direkt die PCB/Schaltplan-Automatisierungswerkzeuge der JialiCAD EDA Professional Edition steuern.

v1.0 wurde vollständig auf den offiziellen JLC AI-Stack migriert: Nicht länger abhängig von selbst entwickelten WebSocket-Protokollen und selbst entwickelten Plugins, sondern von Run API Gateway Erweiterung (EDA-Seite)

• easyeda-api-skill Bridge-Server (Protokollseite). Der MCP Server kompiliert jede Tool-Aktion in offizielle eda.* API-Codes, die über den offiziellen Bridge-Server in der EDA ausgeführt werden.

Architektur

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

• MCP server (dieses Repository) kommuniziert über stdio mit der AI IDE;

• Der offizielle Bridge-Server (scripts/bridge-server.mjs, von easyeda-api-skill) wird automatisch erkannt/gestartet, hört auf Ports 49620-49629, Singleton-Ausführung;

• Die Run API Gateway Erweiterung scannt in der JialiCAD EDA Professional Edition automatisch Ports und verbindet sich (muss im Erweiterungs-Manager Externe Interaktion aktiviert haben), empfängt execute-Nachrichten zur Ausführung mit new AsyncFunction('eda', code).

Related MCP server: JLCEDA MCP Server

Voraussetzungen

• Node.js >= 18 (empfohlen 22 LTS)

• JialiCAD EDA Professional Edition V3.2+

• In JialiCAD EDA die offizielle Run API Gateway Erweiterung installieren:

  • Erweiterungs-Marktplatz: https://jlcext.com/item/oshwhub-official/run-api-gateway

  • Quellcode: https://github.com/easyeda/eext-run-api-gateway

  • Nach der Installation unter Erweitert → Erweiterungs-Manager → Run API Gateway → Konfiguration Externe Interaktion aktivieren

• (Optional) Offizielles easyeda-api skill: https://github.com/easyeda/easyeda-api-skill

Installation & Build

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）

Konfiguration

Erstellen Sie eine .mcp.json im Projektverzeichnis:

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

Starten Sie beim ersten Gebrauch zuerst den Bridge-Server (oder lassen Sie ihn vom MCP server automatisch starten) und stellen Sie in JialiCAD EDA sicher, dass die Run API Gateway Erweiterung verbunden ist (im oberen Menü erscheint API Gateway).

Umgebungsvariablen

Werkzeugliste (59)

Statusabfragen (9)

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

Komponentenoperationen (6)

pcb_move_component / pcb_relocate_component / pcb_batch_move / pcb_select_component pcb_delete_selected / pcb_create_component

Leiterbahnen / Vias (4)

pcb_route_track / pcb_create_via / pcb_delete_tracks / pcb_delete_via

Kupferflächen / Keepout-Bereiche (4)

pcb_create_copper_pour / pcb_delete_pour / pcb_create_keepout / pcb_delete_keepout

Siebdruck (3)

pcb_get_silkscreens / pcb_move_silkscreen / pcb_auto_silkscreen

Erweiterte Constraints (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

Schaltplan / Dokumentation (4)

sch_get_state / sch_get_netlist / sch_run_drc / pcb_open_document

PCB-Agent (1, benötigt ANTHROPIC_API_KEY)

pcb_agent - Intelligenter Agent, der selbstständig mehrschrittige Operationen zur Lösung komplexer Aufgaben orchestriert

Berechnungswerkzeuge (2)

calc_impedance / calc_trace_width

Offizielle Bridge-Operation (4, neu in v1.0)

pcb_bridge_status - Bridge-Server Gesundheitsstatus (EDA-Verbindungsanzahl/aktives Fenster) pcb_list_eda_windows - Alle verbundenen EDA-Fenster auflisten pcb_select_eda_window - Aktives EDA-Fenster auswählen (Zielfenster bei mehreren geöffneten Fenstern angeben) pcb_execute_code - Beliebigen offiziellen eda.* API-Code direkt in der EDA ausführen (Fortgeschritten/Fehlersuche)

Koordinateneinheiten sind alle mil. Die Verwendung von pcb_execute_code ist identisch mit dem offiziellen easyeda-api-skill: Der Code wird in der Form return await eda.dmt_Project.getCurrentProjectInfo(); zurückgegeben.

Erweiterte Funktionen (6, neu in v1.1)

pcb_bom_export - PCB-BOM exportieren (JSON + CSV, aggregierte Menge/Referenzbezeichner/Netz nach Bauteilname) pcb_net_connectivity_check - Netzverbindungsprüfung (nicht verdrahtete/Einzelpad-Netze markieren) pcb_current_density_report - Schätzung der Stromtragfähigkeit jedes Netzes (IPC-2221), niedrige Netze markieren pcb_fanout_component - Fanout-Vias für alle Pads der angegebenen Komponente erstellen pcb_auto_route_nets - Grundlegendes autorouting (L-Form zweilagig: horizontal oben + vertikal unten + Vias, DRC-Nachprüfung erforderlich) pcb_drc_autofix - DRC-Selbstreparatur (aktuell wird Silkscreen-Konflikt automatisch angeordnet), gibt Vorher-/Nachher-Vergleich zurück

Erweiterte Funktionen v2 (4, neu in v1.2)

pcb_component_clearance_check - Paarweiser Abstandscheck zwischen Komponenten, Verstöße unterhalb des Schwellwerts markieren pcb_route_differential_pairs - Automatisches Routing von Differenzialpaaren (paralleles L-Routing für positives/negatives Netz, meldet Längenabweichungen) pcb_design_health_report - Design-Gesundheitsbericht mit einem Klick (BOM+Konnektivität+Stromtragfähigkeit+DRC+Abstand, READY/NEEDS_WORK/POOR Bewertung) pcb_auto_fanout_and_route - Pipeline: Fanout aller Komponenten → Autorouting aller Netze → DRC → Silkscreen-Selbstreparatur

Erweiterte Funktionen v3 (4, neu in v1.3)

pcb_auto_place_components - Automatische Platzierung: Komponenten zum Pad-Schwerpunkt verschieben (Optimierung erster Ordnung) pcb_netlist_report - Netlist-Bericht aus PCB-Pads generieren (Komponente→Pin→Netz / Netz→Komponente) pcb_design_snapshot / pcb_design_diff - Design-Snapshot und Differenzvergleich (neu/hinzugefügt/entfernt/verschoben) pcb_auto_route_nets Upgrade - Einlagiges Hindernisvermeidungsrouting (Pad+Clearance umgehen) oder zweilagiges L-Routing (useVias) pcb_bom_export Upgrade - Unterstützt lcscCodes Materialnummernzuordnung (LCSC API geschützt, kann nicht automatisch abgefragt werden)

Erweiterte Funktionen v4 (3, neu in v1.4)

sch_generate_from_netlist - Importieren einer Netlist über die offizielle sch_Netlist.setNetlist zur Schaltplangenerierung (EasyEDA/JLCEDA/Protel2/PADS/Allegro/DISA/DSNET) sch_generate_from_pcb - Mit einem Klick: PCB-Netlist-Bericht → Protel2-Netlist → Import zur Schaltplangenerierung pcb_eprj3_project_info - .eprj3 Projektinspektor (Verzeichnis/Dateien: Index, Schaltplan-/PCB-/Panel-Liste, Quelldatei-Datensatzstatistik)

Projektstruktur

├── 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

Verifizierung

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

Migrationshinweise (v0.1 → v1.0)

• EDA-Seite: Selbst entwickeltes jlc-bridge Plugin → offizielle Run API Gateway Erweiterung (kein Plugin-Code-Wartung erforderlich)

• Protokollseite: Eigenentwickeltes ws://127.0.0.1:18800/ws/bridge → offizieller Bridge-Server (49620-49629, Handshake-Verifizierung)

• Werkzeugseite: 35 Aktions-Handler wurden unverändert als offizielle eda.* Code-Vorlagen migriert (generiert von scripts/port-plugin.mjs), MCP-Werkzeugschnittstelle voll kompatibel mit v0.1

• Neu: pcb_bridge_status / pcb_list_eda_windows / pcb_select_eda_window / pcb_execute_code

Lizenz

MIT