Altium Designer MCP: символы, посадочные места и плата через агента

coffeenmusic/altium-mcp· Проверено 12.11.2026· 222на GitHub

Подключает агента к Altium Designer: читать проект и плату, создавать символы и посадочные места по даташиту, расставлять компоненты, проверять DRC и ERC. Второй вариант пишет файлы библиотек без запуска Altium.

2 реализации:

Работает с запущенным Altium на Windows через DelphiScript: проект, схема, плата, трассировка, шелкография, выходные задания; 71 инструмент.

Как подключить

Что сделать до подключения

Windows и установленный Altium Designer: сервер сам находит его по реестру

Python от 3.10 до 3.14 в PATH

Для Claude Desktop: скачать altium-mcp.dxt со страницы Releases и поставить через File → Settings → Extensions → Advanced → Install Extension…

Для других клиентов: склонировать репозиторий и запускать start_server.py; при первом запуске он сам создаёт виртуальное окружение

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio altium \
  -- python '<путь к папке altium-mcp>\start_server.py'

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.altium]
command = "python"
args = ["<путь к папке altium-mcp>\\start_server.py"]

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "altium": {
      "command": "python",
      "args": ["<путь к папке altium-mcp>\\start_server.py"]
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "altium": {
      "type": "stdio",
      "command": "python",
      "args": ["<путь к папке altium-mcp>\\start_server.py"]
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "altium": {
      "command": "python",
      "args": ["<путь к папке altium-mcp>\\start_server.py"]
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "altium": {
      "command": "python",
      "args": ["<путь к папке altium-mcp>\\start_server.py"]
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "altium": {
        "type": "local",
        "command": ["python", "<путь к папке altium-mcp>\\start_server.py"]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "altium": {
      "command": "python",
      "args": ["<путь к папке altium-mcp>\\start_server.py"]
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "altium": {
      "command": "python",
      "args": ["<путь к папке altium-mcp>\\start_server.py"]
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

get_project_infoчитает параметры и документы проекта

get_project_componentsперечисляет компоненты проекта

get_erc_violationsсобирает ошибки ERC

run_drcзапускает проверку DRC

get_board_summaryсводит размеры и состав платы

get_component_dataчитает данные компонента

create_schematic_symbolсоздаёт символ схемы

create_pcb_footprintсоздаёт посадочное место

search_library_symbolищет символ в библиотеке

build_schematicрисует схему на новом листе

edit_schematicправит лист схемы

place_componentsрасставляет компоненты на плате

check_placementпроверяет зазоры и перекрытия

route_connectionsтрассирует соединения

get_pcb_layer_stackupчитает стек слоёв

set_pcb_layer_visibilityвключает и прячет слои

auto_place_silkscreenрасставляет позиционные обозначения

run_output_jobsзапускает выходные задания

get_screenshotделает снимок окна Altium

run_altium_scriptвыполняет DelphiScript

Показано 20 из 71.

Сам читает и пишет файлы .PcbLib и .SchLib, Altium запускать не нужно: библиотеки, 3D-модели STEP, сравнение и слияние, автоматические резервные копии; 34 инструмента.

Как подключить

Что сделать до подключения

Скачать готовый бинарник для Windows, macOS или Linux со страницы Releases; Claude Desktop ставит расширение altium-designer-mcp.mcpb

Разрешить папки с библиотеками флагом --allow или в config.json в allowed_paths: за их пределами сервер ничего не трогает

Писать в конфиге клиента абсолютные пути: клиенты не ищут программу в PATH и не раскрывают ~

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio altium-designer-mcp \
  -- '<полный путь к altium-designer-mcp>' --allow '<папка с библиотеками>'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.altium-designer-mcp]
command = "<полный путь к altium-designer-mcp>"
args = ["--allow", "<папка с библиотеками>"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "altium-designer-mcp": {
      "command": "<полный путь к altium-designer-mcp>",
      "args": ["--allow", "<папка с библиотеками>"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "altium-designer-mcp": {
      "type": "stdio",
      "command": "<полный путь к altium-designer-mcp>",
      "args": ["--allow", "<папка с библиотеками>"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "altium-designer-mcp": {
      "command": "<полный путь к altium-designer-mcp>",
      "args": ["--allow", "<папка с библиотеками>"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "altium-designer-mcp": {
      "command": "<полный путь к altium-designer-mcp>",
      "args": ["--allow", "<папка с библиотеками>"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "altium-designer-mcp": {
        "type": "local",
        "command": [
          "<полный путь к altium-designer-mcp>",
          "--allow",
          "<папка с библиотеками>"
        ]
      }
    }
  }
}

{
  "mcpServers": {
    "altium-designer-mcp": {
      "command": "<полный путь к altium-designer-mcp>",
      "args": ["--allow", "<папка с библиотеками>"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "altium-designer-mcp": {
      "command": "<полный путь к altium-designer-mcp>",
      "args": ["--allow", "<папка с библиотеками>"]
    }
  }
}

Инструменты сервера

read_pcblibчитает посадочные места из .PcbLib

write_pcblibзаписывает посадочные места

read_schlibчитает символы из .SchLib

write_schlibзаписывает символы

search_componentsищет компоненты по библиотекам

render_footprintрисует посадочное место символами

render_symbolрисует символ символами ASCII

extract_styleснимает стиль с библиотеки

diff_librariesсравнивает две библиотеки

update_padменяет свойства площадки

batch_updateправит все компоненты разом

copy_component_cross_libraryкопирует компонент в другую библиотеку

bulk_renameпереименовывает по шаблону

merge_librariesсливает библиотеки

validate_libraryпроверяет библиотеку на ошибки

extract_step_modelдостаёт встроенную модель STEP

restore_backupвосстанавливает резервную копию

Показано 17 из 34.

Что попросить агента

«Сделай символ схемы по приложенному даташиту <микросхема>, возьми открытый символ как образец»Altium MCP Server прочитает образец через get_library_symbol_reference и создаст символ через create_schematic_symbol

«Создай посадочное место для SMD-детали из даташита и добавь его в открытую PcbLib»Altium MCP Server вызовет create_pcb_footprint

«Расставь выбранные детали импульсного стабилизатора, проверь зазоры и покажи скриншот»Altium MCP Server вызовет place_components, check_placement и get_screenshot

«Проверь, готов ли проект к производству: несохранённые файлы, ошибки ERC, какие слои в задании Gerber»Altium MCP Server вызовет get_project_info, get_erc_violations и get_outjob_settings

«Создай посадочное место резистора 0603 по IPC-7351B в <библиотека>.PcbLib»altium-designer-mcp запишет площадки, шелкографию и границу через write_pcblib и покажет результат через render_footprint

Для каких задач

Сделать символ и посадочное место по приложенному даташиту

Найти на плате все детали нужного производителя или выдать список микросхем

Расставить компоненты, проверить зазоры и прислать скриншот результата

Проверить проект перед производством: несохранённые документы, ошибки ERC, слои в задании Gerber

Переименовать, слить или проверить библиотеки .PcbLib и .SchLib без открытия Altium

Ограничения

Altium MCP Server работает только на Windows с установленным Altium Designer; сторонний проект, Altium его не делает

Скрипты Altium теряют память на каждом чтении объекта платы: на больших платах сервер отказывает в вызове, когда Altium близок к пределу

altium-designer-mcp не открывает проекты и платы: только файлы библиотек .PcbLib и .SchLib в разрешённых папках

Бинарники altium-designer-mcp не подписаны: Windows SmartScreen и macOS Gatekeeper предупреждают при первом запуске

Если не работает

Altium MCP Server не стартует с первого раза на медленном интернете

Первая сборка окружения может не уложиться в 60 секунд ожидания клиента. Сборка продолжается в фоне: дождитесь её конца по build.log в %USERPROFILE%\.altium-mcp и перезапустите расширение.

altium-designer-mcp: инструменты видны, но каждый вызов падает с ошибкой пути

Файл библиотеки лежит вне allowed_paths. Добавьте его папку в конфиг или в настройку Library folders расширения Claude Desktop и перезапустите клиент.

altium-designer-mcp: клиент пишет Failed to connect

Запустите в терминале <бинарник> <конфиг>: сервер должен молча ждать ввода. Если он печатает ошибку, исправьте её — обычно это опечатка в allowed_paths или нет файла конфига.

altium-designer-mcp на Windows: ошибки пути в конфиге

Удвойте каждый \ в JSON или пишите прямые слеши. Переменные вида %APPDATA% внутри JSON не раскрываются, нужен настоящий путь.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Altium MCP Server	coffeenmusic	222	локально	не нужен	71	11 ноября 2026
altium-designer-mcp	Embedded Society	93	локально	не нужен	34	9 ноября 2026

Частые вопросы

Нужно ли открывать Altium?

Для Altium MCP Server — да: он передаёт команды в запущенный Altium через DelphiScript, для работы с платой нужный документ должен быть открыт. altium-designer-mcp пишет файлы библиотек сам, Altium для него не нужен, он работает и на macOS и Linux.

Как поставить Altium MCP в Claude Desktop?

Скачайте altium-mcp.dxt со страницы Releases и в Claude Desktop на Windows выберите File → Settings → Extensions → Advanced → Install Extension…. У altium-designer-mcp своё расширение altium-designer-mcp.mcpb, ставится так же.

Сломает ли агент мои библиотеки?

altium-designer-mcp перед удалением, правкой и слиянием сам делает резервную копию файла и хранит 5 последних; многие операции поддерживают dry_run для предпросмотра. Altium MCP Server оставляет созданные символы несохранёнными, чтобы вы проверили и сохранили их сами.

Может ли агент развести плату?

У Altium MCP Server есть route_track и route_connections: лабиринтный трассировщик кладёт сегменты под 0, 45 и 90 градусов с соблюдением зазоров. На 6-слойной плате он полностью развёл 11 групп из 12.

Что такое Altium Designer MCP?

MCP-сервер, через который агент работает с Altium Designer. Altium MCP Server управляет открытым проектом и платой, altium-designer-mcp создаёт и правит файлы библиотек. Оба сторонние, Altium их не выпускает.

Как подключить Altium MCP к Claude Code или Cursor?

Для altium-designer-mcp пропишите полный путь к бинарнику и флаг --allow с папкой библиотек: готовые конфиги во вкладках блока «Как подключить». Для Altium MCP Server автор советует попросить Claude Code поставить его прямо из репозитория.

Работает ли сервер из России?

Оба сервера работают на вашем компьютере без ключей и аккаунтов; Altium MCP Server нужен лишь установленный Altium Designer.

Altium Designer MCP: символы, посадочные места и плата через агента

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы