jlceda-mcp-server (공식 스택 마이그레이션 버전)

Jia Li Chuang EDA MCP Server — AI 코딩 어시스턴트가 Jia Li Chuang EDA Professional Edition의 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 서버(이 저장소)는 stdio를 통해 AI IDE와 통신합니다.

• 공식 Bridge Server(scripts/bridge-server.mjs, easyeda-api-skill에서 제공)는 자동으로 발견/실행되며, 포트 49620-49629를 수신하고 단일 인스턴스로 실행됩니다.

• Run API Gateway 확장은 Jia Li Chuang EDA Professional Edition 내에서 포트를 자동으로 스캔하여 연결하고(확장 관리자에서 외부 상호 작용 허용을 체크해야 함), execute 메시지를 수신하여 new AsyncFunction('eda', code)로 실행합니다.

Related MCP server: JLCEDA MCP Server

사전 조건

• Node.js >= 18 (22 LTS 권장)

• Jia Li Chuang EDA Professional Edition V3.2+

• Jia Li Chuang 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 서버가 자동으로 실행하도록 두거나) Jia Li Chuang 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 — 자동 배치: 부품을 패드 무게 중심으로 이동 (1차 최적화) pcb_netlist_report — PCB 패드에서 네트리스트 보고서 생성 (부품→핀→네트워크 / 네트워크→부품) pcb_design_snapshot / pcb_design_diff — 설계 스냅샷 및 차이 비교 (추가/제거/이동) pcb_auto_route_nets 업그레이드 — 단일 레이어 장애물 회피 배선 (패드+clearance 우회) 또는 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

라이선스

MIT