kicad-mcp-pro

KiCad MCP Pro — это сервер протокола контекста модели (Model Context Protocol) для рабочих процессов KiCad EDA. Он предоставляет инструменты, ресурсы и подсказки для автоматизации схем, печатных плат, валидации, DFM и экспорта производства.

Теперь сервер запускается с ограниченным профилем default: 24 инструмента для чтения и рецензирования вместо полного каталога эксперта из 377 инструментов. Используйте build с режимом записи для контролируемых правок, release с производственным режимом для передачи с участием человека, или expert/full только для продвинутых доверенных клиентов. См. docs/agents/progressive-disclosure.md.

Телеметрия и отчеты об ошибках отключены по умолчанию. Конфигурация OpenTelemetry с согласием описана в docs/configuration.md, а правила конфиденциальности — в docs/privacy.md.

Область применения и честность

KiCad MCP Pro — это профессиональный ассистент для первого прохода проектирования и рецензирования, а не автоматический орган утверждения. ERC/DRC и конвейер экспорта используют собственные движки KiCad. Инструменты целостности сигналов, целостности питания, ЭМС и тепловые — это оценки первого порядка в замкнутой форме (обычно точность ∼5–10%) — быстрый первый проход, не замена 2D/3D полевому решателю, EM/FEA симуляции или формальному утверждению. Поиск живых компонентов по умолчанию использует публичный каталог JLCPCB; Nexar, DigiKey и Mouser доступны только при настройке их учетных данных API. Доля программной поверхности KiCad, которую управляет сервер, открыто отслеживается в матрице паритета возможностей.

Related MCP server: KiCad MCP Server

Идентификация проекта

Быстрый старт

Настольное приложение

Загрузите последний установщик со страницы релизов GitHub. Настольное приложение Tauri автоматически запускает сервер панели управления Python и открывает GUI по адресу http://127.0.0.1:3334/ui. Релизы для настольного приложения запускают соответствующую точную версию бэкенда и проверяют её рукопожатие совместимости с настольным приложением перед использованием; см. Установка.

CLI

uvx kicad-mcp-pro init
uvx kicad-mcp-pro tray
uvx kicad-mcp-pro dashboard --open
uvx kicad-mcp-pro --transport streamable-http --port 3334

Веб-панель

uvx kicad-mcp-pro dashboard --host 127.0.0.1 --port 3334 --open
# http://127.0.0.1:3334/ui

Документация

Документация организована от настройки до эксплуатации:

1. Установка

2. Конфигурация клиента

3. Конфигурация времени выполнения

4. Справочник инструментов

5. Рабочие процессы

6. Процесс релиза

7. Безопасность и конфиденциальность

8. Паритет возможностей KiCad — какую часть программной поверхности KiCad управляет этот сервер

9. Каталог кодов ошибок — стабильные коды ошибок, классы повторных попыток и восстановление

10. Аудит рабочих заказов — текущее состояние рабочего заказа по усилению

Инструмент kicad_capability_parity() сообщает для каждой области рабочего процесса, какую часть программно достижимой поверхности KiCad может управлять этот сервер (в настоящее время 76.3%), отличая подлинные gap от элементов gui-only-no-api, для которых KiCad не предоставляет headless API.

Опубликованный сайт документации доступен по адресу https://oaslananka.github.io/kicad-mcp-pro/.

Транспорты

KiCad MCP Pro поддерживает stdio и Streamable HTTP. Streamable HTTP обслуживается по адресу /mcp по умолчанию и может быть перемещён с помощью KICAD_MCP_MOUNT_PATH.

uvx kicad-mcp-pro --transport streamable-http --host 127.0.0.1 --port 3334

Клиенты Streamable HTTP должны отправлять:

• Accept: application/json, text/event-stream

• Content-Type: application/json

• MCP-Protocol-Version: 2025-11-25 после инициализации

• MCP-Session-Id в последующих запросах, когда KICAD_MCP_STATEFUL_HTTP=1

По умолчанию Streamable HTTP не имеет состояния, поэтому коннекторы в стиле ChatGPT могут инициализировать и вызывать tools/list без прокси для внедрения заголовка сессии. Установите KICAD_MCP_STATEFUL_HTTP=1, чтобы требовать идентификаторы сессий после initialize.

Устаревшие маршруты HTTP+SSE отключены по умолчанию. Установите KICAD_MCP_LEGACY_SSE=1 только для старых клиентов, которые не могут использовать Streamable HTTP.

Установка

Опубликованные пакеты:

uvx kicad-mcp-pro --help
npx kicad-mcp-pro --help

Свежая проверка исходного кода на поддерживаемых хостах Linux:

./scripts/bootstrap-dev.sh
source .dev-env.sh
pnpm run dev:doctor -- --ci

Загрузка репозитория устанавливает проверенные по контрольной сумме Python, uv/uvx, Node.js, pnpm, Task и инструменты Rust в игнорируемые корни внутри каталога проверки и выполняет замороженную установку зависимостей. Она не изменяет глобальные каталоги инструментов. См. руководство по воспроизводимой загрузке для режимов --core-only, --check, очистки, обновления и возможностей KiCad.

Метаданные пакета

Канонические входные метаданные: pyproject.toml для версии пакета и идентификации репозитория, и compatibility.yaml для политики поддержки KiCad и MCP. server.json — это сгенерированный манифест реестра. pnpm run metadata:sync отображает публичные поверхности, а pnpm run metadata:check проверяет их в CI и при валидации релиза.

Использование

Используйте kicad-mcp-pro --help для просмотра команд CLI и docs/client-configuration.md для настройки клиента MCP. Сгенерированный каталог инструментов доступен в docs/tools-reference.generated.md.

Плагин агента и навыки

Этот репозиторий содержит плагин агента на уровне продукта и навыки, специфичные для KiCad, для KiCad MCP Pro. Центральный репозиторий agent-tools должен каталогизировать этот плагин, но манифест и инструкции по рабочим процессам находятся здесь, чтобы они оставались синхронизированными с фактическими инструментами сервера MCP.

Настройка агента

KiCad MCP Pro может быть запущен с помощью опубликованного пакета Python, обёртки npm или метаданных контейнера, объявленных в server.json. Типичные локальные запуски:

uvx kicad-mcp-pro --transport stdio
uvx kicad-mcp-pro --transport streamable-http --host 127.0.0.1 --port 3334
npx kicad-mcp-pro --help

Для проверок исходного кода выполните стандартный путь валидации репозитория перед публикацией изменений плагина:

corepack pnpm run metadata:check
python3 -m json.tool .claude-plugin/plugin.json >/dev/null

Рабочий процесс валидации

Перед тем, как отметить этот плагин как активный из agent-tools, убедитесь, что хотя бы одна совместимая среда выполнения агента может:

1. Обнаружить .claude-plugin/plugin.json.

2. Запустить или подключиться к kicad-mcp-pro через stdio или Streamable HTTP.

3. Вызвать kicad_get_server_info или kicad_get_project_info.

4. Загрузить навык из skills/ и следовать рабочему процессу, не ссылаясь на отсутствующие инструменты.

5. Отдельно сообщать об ERC, DRC, DFM, артефактах экспорта, допущениях и требованиях к ручной проверке.

KiCad MCP Pro — это инженерный помощник, а не автономный орган утверждения производства. Сгенерированные файлы печатных плат и производства требуют квалифицированной человеческой проверки перед изготовлением или сборкой.

Разработка

Новым участникам следует начать с ARCHITECTURE.md, который отображает пять слоёв (транспорт → протокол MCP → оркестрация → слой адаптера KiCad → чистая предметная область) и показывает точно, как добавить новый инструмент. Модель выполнения и стек качественных ворот задокументированы в docs/development/architecture.md.

Проект использует Taskfile.yml для общих команд разработки. После клонирования репозитория:

task install     # Install all dependencies (pnpm + uv)
task verify      # Run the local quality gate: lint → format → typecheck → test → build
task test        # Run unit tests only
task lint        # Run lint and metadata checks
task format      # Auto-format the codebase
task typecheck   # Run strict static type checking
task build       # Build release artifacts
task ci          # Run the local equivalent of the full CI pipeline
task hooks       # Install local git hooks

Все изменения должны проходить task verify перед открытием pull request.

Участие

Прочитайте CONTRIBUTING.md перед открытием pull request. Все изменения должны проходить ворота репозитория: формат, линтер, проверка типов, тесты, рабочий процесс, безопасность и метаданные пакета.

Цитирование этого программного обеспечения

Если вы используете KiCad MCP Pro в исследованиях или технической публикации, цитируйте архивный выпуск через его DOI (см. CITATION.cff для полных метаданных):

@software{aslan_kicad_mcp_pro,
  author  = {Aslan, Osman},
  title   = {KiCad MCP Pro},
  license = {MIT},
  url     = {https://github.com/oaslananka/kicad-mcp-pro},
  doi     = {10.5281/zenodo.21283791}
}

Каждый выпуск GitHub архивируется на Zenodo под этим концептуальным DOI, который всегда разрешается в самую последнюю версию.

Лицензия

KiCad MCP Pro доступен под лицензией MIT.