Konnect

<img src="https://raw.githubusercontent.com/mixelpixx/Konnect/main/resources/images/KiCAD-MCP-Server-rust.svg" alt="KiCAD-MCP-Server Logo" height="240" />


# Konnect *Бета-релиз



**Проектирование печатных плат с помощью ИИ для KiCAD 10.** Konnect — нативный плагин KiCAD (один бинарный файл на Rust), который позволяет Claude и другим ИИ-ассистентам проектировать принципиальные схемы и печатные платы через [Model Context Protocol](https://modelcontextprotocol.io) (MCP).

**203 инструмента в составе 19 наборов инструментов по запросу.** Создание схем, разводка и трассировка печатных плат, ERC/DRC, аудиты проверки проекта, поиск компонентов JLCPCB, референсные схемы и полный конвейер экспорта для производства — со встроенными навыками и агентами, которые обучают Claude соглашениям KiCAD «из коробки».

> **Статус: бета.** Основная цепочка инструментов протестирована и работает, но это молодой релиз, которому нужны реальные испытания и проверка. Issues и PR приветствуются — см. [CONTRIBUTING.md](https://github.com/mixelpixx/Konnect/blob/main/CONTRIBUTING.md) и [соглашения об именовании](https://github.com/mixelpixx/Konnect/blob/main/docs/NAMING_CONVENTIONS.md).

> ## Добавьте исследования в реальном времени в KiCAD MCP и Konnect. Представляем Nimrod
>
> [**Nimrod**](https://nimrod.orchis.ai) — наш MCP-сервер веб-исследований:
> поиск в Google с оценкой качества, чистое извлечение содержимого веб-страниц и глубокие
> многоисточниковые исследования. Проектируйте плату с Konnect, пока Nimrod подтягивает актуальную доступность компонентов, даташиты
> и известные ошибки (errata) — больше никаких догадок на основе годовалых данных обучения
>
> - Работает с claude.ai, Claude Desktop, Claude Code, VS Code и любым MCP-клиентом
> - 1 кредит = 1 поиск · извлечение всегда бесплатно · бесплатный пробный период на 50 кредитов, без карты
> - Официальный реестр MCP: [`ai.orchis/nimrod`](https://registry.modelcontextprotocol.io)

## Зачем существует Konnect

Konnect — преемник [KiCAD-MCP-Server](https://github.com/mixelpixx/KiCAD-MCP-Server),
проекта на Python/TypeScript, который доказал, что проектирование печатных плат с помощью ИИ работает, — и заодно
наглядно показал, где именно эта архитектура заходит в тупик. Konnect был создан,
чтобы исправить эти конкретные проблемы:

**Путь вызова был слишком длинным.** В исходном сервере один вызов инструмента проходит
через TypeScript, валидацию схемы, запускаемый Python-подпроцесс, JSON поверх
stdin/stdout, маршрутизатор команд и, наконец, сгенерированные SWIG прокси-объекты C++, прежде чем
что-либо коснётся вашей платы. Это четыре границы языков и сериализации, каждая
со своими режимами отказа — управление жизненным циклом подпроцесса, разбор stdout,
отфильтровывающий предупреждения, которые KiCAD «утекает» в поток, повторная сборка JSON, разбитого на части. В
Konnect вызов инструмента — это просто вызов функции. Один процесс, один язык, никакой обвязки.

**Поверхность зависимостей была огромной.** Запуск исходного сервера означает, что придётся таскать Node.js
и его дерево npm, Python и его пакеты pip, wxPython, kicad-skip и
SWIG-привязки KiCAD — две экосистемы пакетов плюс слой привязок, и каждая из них —
движущаяся мишень, способная сломать установку. Konnect — это один статический бинарный файл —
20–25 МБ в зависимости от платформы, загрузка ~9 МБ. Ничего не нужно устанавливать
рядом с ним и ничего не нужно подгонять по версиям.

**SWIG — тупиковый путь.** Бэкенд печатных плат исходного сервера зависит от SWIG-привязок Python
в KiCAD, которые KiCAD объявляет устаревшими в пользу своего IPC API. SWIG также оставил
реальные эксплуатационные шрамы: вызов заливки зон, способный вызвать segfault бэкенда, ошибки сравнения
прокси-объектов и резервный путь, который может незаметно подменить бэкенд посреди сессии.
Konnect взаимодействует с KiCAD 10 через официальный IPC API (protobuf поверх NNG) —
интерфейс, в который инвестирует KiCAD, — с правками платы в реальном времени, интегрированными с
собственными механизмами undo/redo KiCAD.

**Правки схем не должны повреждать файлы.** Konnect редактирует файлы `.kicad_sch`
через собственный движок S-выражений с атомарной записью (запись, fsync, переименование), сохранением UUID
и round-trip-тестами — никаких сторонних библиотек схем с известными
пробелами, никаких обходных путей через текстовые манипуляции.

**Экономия контекста — это фича.** Предоставление всех 203 инструментов LLM стоит примерно 23K
токенов контекста при каждом выводе списка. Маршрутизатор Konnect загружает стартовый набор (~2K
токенов) и позволяет модели подключать наборы инструментов по запросу — плюс встроенная наблюдаемость
(`get_recent_calls`, `server_stats`, логи вызовов JSONL), чтобы модель могла диагностировать собственные
сбои инструментов.

Результат — меньше, быстрее устанавливается, соответствует направлению развития KiCAD и
создан для производственного использования, а не для экспериментов. Исходный проект остаётся

открыт, поддерживается и полезен — см. сравнение ниже.

Что он делает

Вместо того чтобы описывать изменения и применять их вручную, ИИ работает с вашим проектом напрямую:

• Размещайте и соединяйте компоненты схемы — добавляйте резисторы, микросхемы, разъёмы; соединяйте их между собой по именам выводов
• Разрабатывайте печатную плату — размещайте, перемещайте, вращайте и трассируйте посадочные места в реальном времени через IPC API KiCAD с полной интеграцией отмены/повтора
• Выполняйте проверки проекта — ERC, DRC, проверка связности, аудит развязывающих конденсаторов, анализ цепей питания, проверка состояния BOM
• Экспортируйте производственные файлы — Gerber, сверловка, BOM, pick-and-place, 3D-модели, PDF
• Ищите компоненты JLCPCB — находите компоненты в наличии в локальном каталоге на 2,5 млн позиций и получайте варианты замены
• Начинайте с референсных схем — шаблоны USB-C, LDO, понижающего преобразователя, STM32, I2C, LED с проверенными номиналами компонентов
• Наблюдайте за процессом — живой просмотрщик схем автоматически обновляется по мере правок со стороны ИИ

Полный каталог инструментов описан в tool-directory.md.

Как это работает

Установка

Из менеджера плагинов KiCAD (рекомендуется)

1. Скачайте пакет для вашей ОС со страницы Releases: konnect-pcm-v<version>-windows.zip, -macos.zip или -linux.zip. Каждый архив содержит серверный бинарник для соответствующей платформы — пакет для macOS является универсальной сборкой, поэтому одной загрузкой покрываются Apple Silicon и Intel. (Артефакты konnect-pcm-* — это пакеты плагина KiCAD; остальные архивы — автономные бинарники сервера.)
2. Откройте KiCAD 10 → Менеджер плагинов и содержимого
3. Нажмите Установить из файла и выберите zip-архив
4. Перезапустите KiCAD

Проверка: откройте Редактор платы → Инструменты → Внешние плагины → вы должны увидеть Konnect.

Сборка из исходников

# protoc is required (protobuf code generation), and cmake (the nng crate
# compiles the NNG C library with it).
# Windows: choco install protoc cmake
# macOS:   brew install protobuf cmake
# Linux:   apt install protobuf-compiler cmake
cargo build --release -p konnect

Установка инструкций для вашего ИИ-клиента

Konnect включает общие skills KiCad для Claude и Codex. Выбирайте клиента при установке, проверке или удалении этих инструкций:

# Existing behavior remains the default: Claude skills, agents, and hooks
konnect init

# Codex installs only the shared skills under ~/.agents/skills
konnect init --client codex
konnect status --client codex
konnect uninstall --client codex

Сохраните --client codex в команде запуска MCP-сервера, чтобы настройка при первом запуске также оставалась внутри каталогов Codex. Например, зарегистрируйте автономный бинарник через Codex CLI так:

codex mcp add konnect -- /path/to/konnect --client codex

Если --client опущен, по умолчанию используется Claude. Установщик ведёт учёт двух клиентов независимо, и установка для Codex не создаёт и не изменяет ~/.claude.

--help у любой подкоманды выводит справку по её использованию и ничего не записывает — konnect init --help описывает установщик, а не запускает его. Аргумент, который Konnect не распознаёт, считается ошибкой, а не игнорируется, поэтому опечатка вроде --cleint codex приведёт к остановке, а не к тихой установке для клиента по умолчанию.

macOS

На странице Releases доступны автономные серверные бинарники как для Apple Silicon (aarch64-apple-darwin), так и для Intel (x86_64-apple-darwin). Они ещё не имеют цифровой подписи, поэтому если вы скачиваете их через браузер, снимите атрибут карантина перед первым запуском:

tar xzf konnect-v*-aarch64-apple-darwin.tar.gz
xattr -d com.apple.quarantine ./konnect   # only needed for browser downloads
./konnect --help

Или соберите из исходников, как описано выше (проверено на Apple Silicon; тот же бинарник target/release/konnect является MCP-сервером).

KiCad на macOS хранит свои инструменты внутри пакета приложения, и они не добавлены в PATH, поэтому укажите их Konnect в ~/Library/Application Support/konnect/config.toml:

kicad_cli = "/Applications/KiCad/KiCad.app/Contents/MacOS/kicad-cli"
kicad_binary = "/Applications/KiCad/KiCad.app/Contents/MacOS/kicad"
# KiCad 10's IPC socket on macOS (enable it in KiCad:
# Preferences → Plugins → "Enable KiCad API")
ipc_address = "ipc:///tmp/kicad/api.sock"

Конфигурация Claude Desktop находится в ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "konnect": {
      "command": "/path/to/konnect"
    }
  }
}

Для Claude Code поместите тот же фрагмент в файл .mcp.json в корне вашего проекта.

Пакет PCM для macOS (konnect-pcm-v<version>-macos.zip) содержит универсальный серверный бинарник, поэтому одной загрузкой покрываются Apple Silicon и Intel. Просмотрщик схем компилируется и запускается на macOS (Tauri 2 использует системный WKWebView — WebView2 требуется только на Windows), но пока не получил столь же обширного практического применения, как сборка для Windows.

Настройка с Claude Desktop

После установки через PCM серверный бинарник располагается в папке документов KiCAD:

C:\Users\<YOU>\Documents\KiCad\10.0\3rdparty\plugins\com_github_mixelpixx_konnect\bin\konnect.exe

Отредактируйте файл %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "konnect": {
      "command": "C:\\Users\\<YOU>\\Documents\\KiCad\\10.0\\3rdparty\\plugins\\com_github_mixelpixx_konnect\\bin\\konnect.exe"
    }
  }
}

Перезапустите Claude Desktop — и инструменты Konnect появятся. Для Claude Code поместите тот же фрагмент в файл .mcp.json в корне вашего проекта (см. examples/).

Просмотрщик схем

Автономный просмотрщик, который автоматически обновляется при изменении файла схемы:

schematic-viewer.exe path\to\your\root_schematic.kicad_sch

Укажите ему корневой лист иерархического проекта — и все вложенные листы тоже будут отрисованы, причём на панели инструментов появится селектор листов с отступами по глубине иерархии. Изменения, сохранённые из KiCAD (или внесённые ИИ через инструменты работы со схемами), перерисовывают только изменившиеся листы и обновляют вид в реальном времени — рендеринг выполняется по снимкам во временной папке, поэтому просмотрщик никогда не блокирует сохранение в KiCAD. Панорамирование — перетаскиванием мышью, масштабирование — колёсиком, 0 — вписать в окно, R — обновить, открытие другого файла — перетаскиванием (drag-and-drop). Также может быть запущен ИИ через инструмент open_schematic_viewer.

Требуется среда выполнения WebView2 (предустановлена в Windows 10/11) и установленный KiCAD для kicad-cli (обнаруживается автоматически, либо передайте --kicad-cli <path>). Собирается отдельно от основного рабочего пространства — шаги сборки см. в DEV.md.

Требования

• KiCAD 10 (Windows — наиболее протестированная платформа; macOS работает из релизных бинарников или сборки из исходников — см. раздел о macOS выше. Linux компилируется и проходит тесты в CI, но пока не прошёл QA на каждой платформе по отдельности; оба пункта отслеживаются в дорожной карте)
• kicad-cli (поставляется вместе с KiCAD — используется для экспорта, ERC, DRC)
• Для большинства инструментов PCB: запущенный KiCAD с открытой целевой платой (IPC API). place_component, move_component и rotate_component могут безопасно переключаться на закрытый файл платы, когда IPC недоступен. flip_component намеренно требует закрытую плату, поскольку в KiCAD IPC нет нативной команды переворота посадочного места.

Лицензия: бесплатно для маленьких

Konnect распространяется по лицензии GNU AGPL-3.0.

Если вы любитель, студент, фрилансер или проект с открытым исходным кодом: пользуйтесь свободно, без каких-либо условий. Проектируйте платы, выпускайте их, продавайте их.

Если вы компания: AGPL требует, чтобы всё, что вы создаёте на основе Konnect или вокруг него — включая программное обеспечение, предоставляемое по сети, — было открыто под той же лицензией. Если это вам не подходит, доступны коммерческие лицензии: см. COMMERCIAL.md.

Связь с KiCAD-MCP-Server

Оригинальный проект на Python/TypeScript остаётся полностью открытым (MIT) и поддерживаемым. Konnect — это место, где происходит новая разработка: проверенная архитектура, перестроенная для продакшена:

Устранение неполадок

Плагин не появляется в KiCAD — устанавливайте через Менеджер плагинов и контента (Plugin and Content Manager), а не копированием вручную, затем перезапустите KiCAD.

Инструменты PCB возвращают «KiCAD должен быть запущен с открытой платой» — сначала откройте KiCAD с этой платой; большинство инструментов PCB взаимодействуют с запущенным редактором платы. Такое сообщение выдаётся только когда KiCAD недоступен: если KiCAD запущен, а инструмент всё равно отказывается работать, значит причина отказа указана самим инструментом. place_component, move_component и rotate_component могут переключиться на закрытый файл платы, если ни один процесс KiCAD недоступен; flip_component требует доступный процесс и отказывает, пока KiCAD держит эту плату открытой.

Настройку сокета, инструменты, которые не появляются после load_toolset, и восстановление транзакций см. в docs/TROUBLESHOOTING.md.

«kicad-cli не найден» — стандартные пути установки определяются автоматически; задайте путь явно в диалоге настроек плагина, в файле settings.json рядом с бинарником или в konnect.toml в рабочей директории. (Файл с любым другим именем работает, только если передан через --config.)

Поддержка

• Ошибки и запросы новых функций: GitHub Issues
• Дорожная карта: ROADMAP.md
• Участие в разработке: CONTRIBUTING.md