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) で実行。

Related MCP server: JLCEDA MCP Server

前提条件

• 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 が表示される）。

環境変数

ツール一覧（59 個）

状態照会 (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

部品操作 (6)

pcb_move_component / pcb_relocate_component / pcb_batch_move / pcb_select_component pcb_delete_selected / pcb_create_component

配線 / ビア (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 / pcb_open_document

PCB Agent (1、ANTHROPIC_API_KEY が必要)

pcb_agent — インテリジェント Agent、複数ステップの操作を自律的に組み合わせて複雑なタスクを完了

計算ツール (2)

calc_impedance / calc_trace_width

公式 Bridge 運用 (4、v1.0 新規)

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(); のように結果を返す形式。

高度な機能 (6、v1.1 新規)

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 型2層：トップ水平+ボトム垂直+ビア、DRC 再確認が必要） pcb_drc_autofix — DRC 自動修復（現在はシルク競合の自動配置に対応）、修復前後の比較を返す

高度な機能 v2 (4、v1.2 新規)

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 → シルク自動修復

高度な機能 v3 (4、v1.3 新規)

pcb_auto_place_components — 自動配置：部品をパッドの重心に移動（一次最適化） pcb_netlist_report — PCB パッドからネットリストレポートを生成（部品→ピン→ネット / ネット→部品） pcb_design_snapshot / pcb_design_diff — デザインスナップショットと差分比較（追加/削除/移動） pcb_auto_route_nets アップグレード — 単層障害物回避配線（パッド+クリアランスを迂回）または2層 L 型（useVias） pcb_bom_export アップグレード — lcscCodes 部品番号マッピングに対応（LCSC API は保護されており自動照会不可）

高度な機能 v4 (3、v1.4 新規)

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）

移行説明（v0.1 → v1.0）

• 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

License

MIT