jlceda-mcp-server (версия с официальным стеком миграции)

MCP-сервер для JLCPCB EDA — позволяет AI-ассистентам напрямую управлять PCB/схемами в профессиональной версии JLCPCB EDA.

v1.0 полностью мигрирована на официальный стек JLC AI: больше не используется собственный протокол WebSocket и собственный плагин, вместо этого используются:

• Расширение Run API Gateway (со стороны EDA)

• easyeda-api-skill Bridge Server (со стороны протокола). MCP-сервер компилирует каждое действие инструмента в официальный код API eda.*, который выполняется в EDA через официальный Bridge Server.

Архитектура

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

• MCP-сервер (этот репозиторий) общается с AI IDE через stdio;

• Официальный Bridge Server (scripts/bridge-server.mjs, из easyeda-api-skill) автоматически обнаруживается/запускается, прослушивает порты 49620-49629, работает в единственном экземпляре;

• Расширение Run API Gateway в профессиональной версии JLCPCB EDA автоматически сканирует порты и подключается (необходимо включить Разрешить внешнее взаимодействие в менеджере расширений), получает сообщения execute и выполняет их с помощью new AsyncFunction('eda', code).

Related MCP server: JLCEDA MCP Server

Предварительные требования

• Node.js >= 18 (рекомендуется 22 LTS)

• Профессиональная версия JLCPCB EDA V3.2+

• Установите официальное расширение Run API Gateway в JLCPCB EDA:

  • Площадка расширений: 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-серверу запустить его автоматически) и убедитесь, что расширение Run API Gateway подключено в JLCPCB EDA (в верхнем меню появится 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 — Интеллектуальный агент, самостоятельно оркестрирующий многошаговые операции для выполнения сложных задач

Инструменты расчета (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 — Непосредственное выполнение произвольного официального кода API eda.* в EDA (продвинутый/отладка)

Все координаты в mil. pcb_execute_code работает так же, как официальный easyeda-api-skill: код должен возвращать результат в форме return await eda.dmt_Project.getCurrentProjectInfo();

Расширенные функции (6, новое в v1.1)

pcb_bom_export — Экспорт BOM PCB (JSON + CSV, агрегация количества/позиционных обозначений/сетей по имени компонента) pcb_net_connectivity_check — Проверка связности сетей (отметка неразведенных сетей / сетей с одним контактной площадкой) pcb_current_density_report — Оценка токопроводящей способности каждой сети (IPC-2221), отметка сетей с низким значением pcb_fanout_component — Создание переходных отверстий для всех контактных площадок указанного компонента pcb_auto_route_nets — Базовая автоматическая трассировка (L-образная двухслойная: верхний слой горизонтально + нижний слой вертикально + переходные отверстия, требуется проверка 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 обновление — Однослойная трассировка с обходом препятствий (обход контактных площадок+зазоров) или двухслойная 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