Konnect：用 AI 接管你的 KiCAD 电路板设计

你正在用 Altium Designer 画一块 STM32 核心板，布局改了七八版，每次都要手动检查 DRC、拉线、对齐元器件——改到第三天，手指酸了，脖子也僵了。更要命的是，AI 助手已经能帮你写代码、调试 bug，但一让你描述"把晶振走线缩短到 3mm 以内并在背面铺铜接地"，脑子里已经开始发怵。

Konnect 想解决的，就是这件事：让 AI 直接操作你的 PCB 文件，而不是让你充当人肉翻译。

---

背景：KiCAD-MCP-Server 是怎么诞生的

这个项目的作者 mixelpixx 在此之前做了一个 KiCAD-MCP-Server（Python/TypeScript），首次验证了"AI 驱动的 PCB 设计"这条路的可行性。但那套架构很快碰到了天花板：TypeScript → Python 子进程 → SWIG 绑定 → C++ 代理对象，一次工具调用要穿越四层语言边界，每层都有自己的失败模式——子进程生命周期管理、stdout 解析（KiCAD 会往 stdout 泄漏警告）、JSON 重组……更麻烦的是，SWIG 绑定依赖 KiCAD 即将废弃的旧接口，KiCAD 官方已经转向 IPC API（protobuf over NNG）。

Konnect 就是这套思路的全面重写：单进程、单语言（Rust）、原生接入 KiCAD 10 的 IPC API。

---

它能做什么

Konnect 是一个原生 KiCAD 10 插件，也是一个 MCP（Model Context Protocol）服务器。安装后，Claude 等 AI 助手可以通过 MCP 协议直接调用它的 203 个工具，覆盖以下场景：

类别	具体能力
原理图编辑	添加元器件、导线接线、按引脚名称连线
PCB 布局	放置/移动/旋转/翻转封装，实时通过 KiCAD IPC API 写入
设计检查	ERC（电气规则检查）、DRC（设计规则检查）、去耦审查、电源轨审查、BOM 健康检查
导出制造文件	Gerber、钻孔文件、BOM、贴片机坐标、3D 模型、PDF
JLCPCB 零件搜索	搜索本地 250 万零件目录、查找替代料
参考电路模板	USB-C、LDO、Buck 转换器、STM32、I2C、LED 等参考设计
实时预览	原理图查看器（Tauri 构建）随 AI 编辑自动刷新

---

技术架构：为什么选 Rust

Konnect 不是一个普通的 Python 脚本，而是一个精心分层的 Rust 工作空间：

crates/konnect/         ← MCP 服务器入口（CLI + stdio/HTTP transport）
crates/konnect-core/     ← 路由层 + 203 工具注册 + 工具集动态加载
crates/konnect-sexp/     ← S-Expression 解析引擎，操作 .kicad_sch 文件
crates/konnect-ipc/      ← KiCAD 10 IPC API 客户端（NNG + protobuf）
crates/schematic-editor/ ← 原理图编辑核心
crates/schematic-viewer/ ← Tauri 构建的原理图 GUI 预览器

关键设计决策：

• 原理图编辑走 Konnect 自研的 S-Expression 引擎，对 .kicad_sch 文件做原子写入（写 → fsync → rename），不依赖任何第三方库，也不污染版本历史。带 UUID 保留和往返测试。
• PCB 编辑走 KiCAD 10 IPC API（NNG + protobuf），实时写入、与 KiCAD 的 undo/redo 完全集成。place_component、move_component、rotate_component 在 KiCAD 进程不可达时有安全降级。
• 传输层：默认 MCP JSON-RPC over stdio，也支持 Streamable HTTP（transport = "http" / "both"）。
• 上下文经济：一次性暴露 203 个工具需要约 23K tokens，Konnect 只预加载启动工具包（约 2K tokens），其余工具集按需加载。内置可观测性（get_recent_calls、server_stats、JSONL 调用日志），AI 可以自我诊断工具调用失败原因。

Cargo.toml 显示主要依赖：tokio（异步运行时）、axum（HTTP/SSE）、nng + prost（KiCAD IPC）、rusqlite（本地 JLCPCB 数据库）、nom（S-Expression 解析）。

---

上手体验

安装（推荐：KiCAD 插件管理器）

1. 从 Releases 下载对应平台的 konnect-pcm-v*.zip
2. KiCAD 10 → Plugin and Content Manager → Install from File → 选择 zip
3. 重启 KiCAD，Tools → External Plugins 下出现 Konnect
4. 在 Claude Desktop 配置中注册 MCP 服务器

# ~/.config/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "konnect": {
      "command": "/path/to/konnect"
    }
  }
}

从源码构建

需要 protoc（protobuf 代码生成）和 cmake（编译 NNG C 库）：

apt install protobuf-compiler cmake
cargo build --release -p konnect

macOS 特殊说明

KiCAD 工具链在 macOS 下位于 App Bundle 内，不在 PATH 上。需要在 ~/Library/Application Support/konnect/config.toml 中手动配置路径。

---

许可证设计：AGPL + 商业授权双轨

Konnect 采用 AGPL-3.0 许可证。个人用户、教育用途、开源项目免费使用，设计作品可自由销售。商业用途：任何基于或围绕 Konnect 构建的软件必须以相同许可证开源。如需闭源商业授权，可联系作者获取（见 COMMERCIAL.md）。

---

当前局限与争议

• Beta 状态：核心工具链已测试通过，但发布历史较短（2026 年 7 月创建），缺少大规模真实使用场景反馈。
• 平台支持差异：Windows 平台测试最充分；macOS 预览器未充分 QA；Linux 仅有 CI 验证。
• IPC 工具限制：flip_component 因为 KiCAD IPC 无原生翻转命令，必须在 PCB 文件关闭状态下操作。
• Rust 1.96 MSRV：Rust 版本锁定较高，部分保守系统可能需要额外配置 Rust 工具链。
• 61 个 open issues：对于一个 1.5 月龄的项目来说较活跃，说明功能打磨和用户反馈处于活跃期。

---

行业意义：AI 硬件设计的第一步

Konnect 最有意思的地方，不是某一个工具，而是一个范式验证：当 AI 能直接操作 CAD 文件时，硬件工程师的生产力会发生什么变化？从 Claude Code 到 Cursor，AI 辅助编程已经改变了软件行业；Konnect 正在尝试把同样的逻辑带到硬件领域。

203 个工具、19 个工具集、MCP 协议原生集成、上下文经济设计——这套架构是为生产级使用设计的，不是实验玩具。随着 KiCAD 10 持续迭代（IPC API 越来越成熟），Konnect 的能力边界会同步扩展。