altium-kp — MCP-сервер для Altium Designer

MCP server that lets an AI assistant (Claude Code, Claude Desktop, Cursor, any MCP client) drive Altium Designer on Windows without screen automation: schematic entry, ГОСТ/ЕСКД-style drawings, ECO, board outline, design rules, placement, autorouting, DRC, board statistics, DXF export for AutoCAD and BOM generation. Built for student PCB projects (курсовой «Разработка печатного узла средствами САПР»), useful for any Altium work.

Сервер управляет запущенным Altium Designer через его встроенный DelphiScript: генерирует скрипт, запускает его командой X2.EXE -RScriptingSystem:RunScript и получает результат в JSON. Мышь и экран не используются. Модальные окна Altium перехватываются: снимок окна возвращается ассистенту, окно закрывается, скрипт, остановленный в отладчике, снимается. Altium не остаётся заблокированным.

Проверено на Altium Designer 25.5 (Windows 11). Должно работать на AD 20+.

Что умеет (47 инструментов, полный список — TOOLS.md)

Пример результата: examples/blinker — мультивибратор от пустой папки до схемы Э3 на листе A3 с основной надписью, разведённой платы, DRC, DXF и перечня элементов, одним скриптом.

Related MCP server: KiCAD MCP Server

Установка

Нужны Windows, Altium Designer, Python 3.10+.

git clone https://github.com/luxsordel/altium-kp-mcp.git
cd altium-kp-mcp
python -m venv .venv
.venv\Scripts\pip install -e .

Claude Code:

claude mcp add --scope user altium-kp -- "<path>\altium-kp-mcp\.venv\Scripts\python.exe" -m altium_kp

Claude Desktop / другие клиенты (claude_desktop_config.json):

{
  "mcpServers": {
    "altium-kp": {
      "command": "C:\\path\\altium-kp-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "altium_kp"]
    }
  }
}

Сервер сам находит C:\Program Files\Altium\AD*\X2.EXE (новейшую версию) и запускает Altium, если тот закрыт. Переменные окружения: ALTIUM_X2 — путь к X2.EXE, ALTIUM_KP_EXCHANGE — папка обмена (по умолчанию C:\Users\Public\altium_kp). Для текстов по ГОСТ нужен шрифт ISOCPEUR (ставится с AutoCAD; можно указать другой в sch_gost_style/sch_gost_sheet).

Типичный сценарий (что просить у ассистента)

1. «Создай проект в папке X с библиотекой Miscellaneous Devices.IntLib и сгенерируй библиотеку ГОСТ-УГО с посадочными местами…»

2. «Нарисуй схему по этому списку цепей на листе A2 по ГОСТ, основная надпись: …» → sch_place_components + sch_wire + sch_gost_sheet + sch_gost_style

3. «Проверь ERC и перенеси на плату» → project_compile, pcb_import_changes

4. «Рассчитай печатный монтаж для класса точности 3, плата 100×80, выставь правила, расставь компоненты, разведи» → calc_*, pcb_set_board, pcb_set_rules, pcb_place_components, pcb_autoroute

5. «DRC, коэффициент заполнения, DXF для AutoCAD и перечень элементов» → pcb_run_drc, pcb_statistics, pcb_export_dxf, bom_export

Ограничения (честно)

• Только Windows и только с установленным Altium Designer (используется его скриптовый движок).

• Зеркалирование размещённых компонентов из скрипта не работает — для транзисторов есть зеркальные УГО (VT_NPN_M, VT_PNP_M).

• Приоритет правил из скрипта не задаётся — pcb_set_rules делает области правил ширины непересекающимися.

• Толщина/материал платы — в Layer Stack Manager (скриптовое API стека в AD25 только для чтения).

• Коэффициенты в calc_pcb_mounting (j_доп = 20 А/мм², позиционные допуски) типовые — сверяйте с вашей методичкой.

• Если в Altium открыт другой проект с документами тех же имён, компилятор Altium их путает — project_compile предупреждает, закройте лишний проект (project_close).

• Автотрассировщик и pcb_auto_place_grid — отправные точки; качественная расстановка задаётся координатами (by_center).

• Сервер не подписан и запускает Altium с параметрами командной строки; проверяйте результат скриншотами (altium_screenshot).

Как это устроено

• altium_kp/bridge.py — запуск DelphiScript в Altium, ожидание результата, перехват окон, межпроцессная блокировка.

• altium_kp/prelude.pas, lib.pas — помощники DelphiScript (JSON-вывод, поиск проектов/документов, схема, плата).

• altium_kp/server*.py — инструменты MCP; gost.py — геометрия УГО и основной надписи; calc.py, export.py — расчёты, DXF, перечень.

Подводные камни DelphiScript, найденные по ходу (могут пригодиться): обратный слэш в строковых литералах — escape (используйте Chr(92)); if True or (...) не разбирается; объекты платы, сложенные в TList, нельзя удалить (ищите и удаляйте по одному); Rule.Priority не присваивается; процессы ECO/компиляции работают с «текущим» проектом (DM_SetAsCurrentProject); компилятор кэширует единицы и размер листа при открытии документа.

Благодарности

Идея связки Python ↔ DelphiScript и шаблон скриптового проекта KP_Exec.PrjScr — по мотивам coffeenmusic/altium-mcp (MIT). Хорошо дополняет этот сервер: embedded-society/altium-designer-mcp — чтение/запись .SchLib/.PcbLib без Altium.

Лицензия

MIT