jlceda-mcp-server (Migración oficial a la pila)

Servidor MCP de Jiali EDA: un conjunto de herramientas de automatización de PCB/esquemáticos que permite a los asistentes de programación con IA controlar directamente la edición profesional de Jiali EDA.

v1.0 migrado completamente a la pila oficial de JLC AI: ya no depende del protocolo WebSocket ni de complementos de desarrollo propio, sino que utiliza Run API Gateway Extension (lado EDA)

• easyeda-api-skill Bridge Server (lado del protocolo). El MCP Server compila cada acción de la herramienta en código de la API oficial eda.*, que se ejecuta en EDA a través del Bridge Server oficial.

Arquitectura

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

• El MCP server (este repositorio) se comunica con el AI IDE a través de stdio;

• El Bridge Server oficial (scripts/bridge-server.mjs, de easyeda-api-skill) se descubre/inicia automáticamente, escucha en los puertos 49620-49629 y se ejecuta como instancia única;

• La extensión Run API Gateway en la edición profesional de Jiali EDA escanea y se conecta automáticamente a los puertos (es necesario marcar Permitir interacción externa en el administrador de extensiones), recibe mensajes execute y los ejecuta con new AsyncFunction('eda', code).

Related MCP server: JLCEDA MCP Server

Requisitos previos

• Node.js >= 18 (se recomienda 22 LTS)

• Edición profesional de Jiali EDA V3.2+

• Instalar la extensión oficial Run API Gateway en Jiali EDA:

  • Tienda de extensiones: https://jlcext.com/item/oshwhub-official/run-api-gateway

  • Código fuente: https://github.com/easyeda/eext-run-api-gateway

  • Después de la instalación, en Avanzado → Administrador de extensiones → Run API Gateway → Configuración, marcar Permitir interacción externa

• (Opcional) Skill oficial easyeda-api: https://github.com/easyeda/easyeda-api-skill

Instalación y compilación

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）

Configuración

Crear .mcp.json en el directorio del proyecto:

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

Al primer uso, iniciar primero el Bridge Server (o dejar que el MCP server lo inicie automáticamente) y confirmar en Jiali EDA que la extensión Run API Gateway está conectada (aparece API Gateway en el menú superior).

Variables de entorno

Lista de herramientas (59)

Consulta de estado (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

Operaciones con componentes (6)

pcb_move_component / pcb_relocate_component / pcb_batch_move / pcb_select_component pcb_delete_selected / pcb_create_component

Trazado / Vías (4)

pcb_route_track / pcb_create_via / pcb_delete_tracks / pcb_delete_via

Planos de cobre / Zonas de exclusión (4)

pcb_create_copper_pour / pcb_delete_pour / pcb_create_keepout / pcb_delete_keepout

Serigrafía (3)

pcb_get_silkscreens / pcb_move_silkscreen / pcb_auto_silkscreen

Restricciones avanzadas (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

Esquemáticos / Documentos (4)

sch_get_state / sch_get_netlist / sch_run_drc / pcb_open_document

Agente PCB (1, requiere ANTHROPIC_API_KEY)

pcb_agent — Agente inteligente que orquesta múltiples pasos para completar tareas complejas

Herramientas de cálculo (2)

calc_impedance / calc_trace_width

Operaciones del Bridge oficial (4, nuevo en v1.0)

pcb_bridge_status — Estado de salud del Bridge Server (conexiones EDA/ventana activa) pcb_list_eda_windows — Lista todas las ventanas EDA conectadas pcb_select_eda_window — Selecciona la ventana EDA activa (especificar destino al tener múltiples abiertas) pcb_execute_code — Ejecuta directamente cualquier código de la API oficial eda.* en EDA (avanzado/depuración)

Las coordenadas están en mil. pcb_execute_code se usa de la misma manera que el skill oficial easyeda-api: El código devuelve el resultado en forma de return await eda.dmt_Project.getCurrentProjectInfo();

Funciones avanzadas (6, nuevo en v1.1)

pcb_bom_export — Exporta la BOM de PCB (JSON + CSV, agrega cantidad/referencias/redes por nombre de componente) pcb_net_connectivity_check — Verificación de conectividad de red (marca redes no enrutadas o con un solo pad) pcb_current_density_report — Estimación de capacidad de corriente de cada red (IPC-2221), marca redes con baja capacidad pcb_fanout_component — Crea vías de abanico para todos los pads de un componente específico pcb_auto_route_nets — Enrutamiento automático básico (tipo L en dos capas: superior horizontal + inferior vertical + vías, requiere revisión DRC) pcb_drc_autofix — Autocorrección DRC (actualmente soporta reordenamiento automático de conflictos de serigrafía), devuelve comparación antes/después

Funciones avanzadas v2 (4, nuevo en v1.2)

pcb_component_clearance_check — Verificación de distancia entre pares de componentes, marca pares que violan el umbral pcb_route_differential_pairs — Enrutamiento automático de pares diferenciales (redes positiva/negativa en paralelo tipo L, reporta desviación de longitud) pcb_design_health_report — Informe de salud de diseño con un clic (BOM+conectividad+capacidad de corriente+DRC+espaciado, puntuación READY/NEEDS_WORK/POOR) pcb_auto_fanout_and_route — Pipeline: abanico de todos los componentes → enrutamiento automático de todas las redes → DRC → autocorrección de serigrafía

Funciones avanzadas v3 (4, nuevo en v1.3)

pcb_auto_place_components — Colocación automática: mueve componentes al centroide de los pads (optimización de primer orden) pcb_netlist_report — Genera informe de lista de redes desde los pads de PCB (componente→pin→red / red→componente) pcb_design_snapshot / pcb_design_diff — Instantánea de diseño y comparación de diferencias (añadido/eliminado/movido) pcb_auto_route_nets actualizado — Enrutamiento con evitación de obstáculos en una sola capa (rodeando pads+clearance) o tipo L en dos capas (useVias) pcb_bom_export actualizado — Soporta mapeo de códigos de pieza lcscCodes (API de LCSC protegida, no se puede consultar automáticamente)

Funciones avanzadas v4 (3, nuevo en v1.4)

sch_generate_from_netlist — Genera esquemático importando lista de redes a través de sch_Netlist.setNetlist oficial (EasyEDA/JLCEDA/Protel2/PADS/Allegro/DISA/DSNET) sch_generate_from_pcb — Un clic: informe de lista de redes de PCB → lista de redes Protel2 → importar para generar esquemático pcb_eprj3_project_info — Inspector de proyectos .eprj3 (directorio/archivo: índice, lista de esquemáticos/PCB/paneles, estadísticas de registros de archivos fuente)

Estructura del proyecto

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

Verificación

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

Notas de migración (v0.1 → v1.0)

• Lado EDA: complemento jlc-bridge de desarrollo propio → extensión oficial Run API Gateway (sin necesidad de mantener código de complemento)

• Lado del protocolo: ws://127.0.0.1:18800/ws/bridge de desarrollo propio → Bridge Server oficial (49620-49629, verificación de handshake)

• Lado de herramientas: 35 manejadores de acciones migrados directamente a plantillas de código oficial eda.* (generados por scripts/port-plugin.mjs), la interfaz de herramientas MCP es completamente compatible con v0.1

• Nuevo: pcb_bridge_status / pcb_list_eda_windows / pcb_select_eda_window / pcb_execute_code

Licencia

MIT