KiCAD MCP 服务器

一个通过自然语言命令使AI助手能够使用KiCAD设计PCB的模型上下文协议(MCP)服务器

  • by LIsha-P-BNC
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 LIsha-P-BNC/kicad_mcp

使用说明

KiCAD MCP服务器🎨

一种模型上下文协议(MCP)服务器,使AI助手能够通过自然语言命令使用KiCAD设计PCB。


🚀 这是什么?

此MCP服务器将AI助手(如Claude)与KiCAD连接起来,允许您使用对话式提示而不是点击菜单来设计完整的PCB。

交互示例:

你说:

Create a new board with ESP32, add an LED with resistor, route the traces, and export Gerbers

系统:

  • 创建KiCAD项目
  • 放置组件
  • 路线连接
  • 运行设计规则检查
  • 导出制造文件

通过自然语言! 🎉


✨ 特性

核心能力

  • 🎯 项目管理 -创建、打开、保存KiCAD项目
  • 📦 元件布局 -使用自然语言搜索和放置组件
  • 🔌 原理图设计 -创建原理图和连接
  • 🛤️ PCB布线 -布线迹线、添加通孔、创建铜浇注
  • ✅ 设计验证 -运行DRC,检查间隙
  • 📤 出口 -生成Gerbers、BOM、拾取和放置、3D模型
  • 🔍 图书馆访问 -搜索223个符号库,155个封装库
  • 💰 JLCPCB集成 -搜索零件数据库,获取定价/库存信息

高级功能

  • 59个专用工具,分为7类
  • 实时电路板可视化
  • 网络类管理
  • 层堆叠配置
  • 设计规则定制
  • 批量组件操作

📋 先决条件

  • Kicad 8.0+ 安装
  • Node.js 18+
  • Python 3.9+
  • MCP兼容客户端 (克劳德桌面、克劳德代码等)

🔧 安装

1.克隆存储库

git clone https://github.com/LIsha-P-BNC/kicad_mcp.git
cd kicad_mcp

2.安装依赖项

npm install
pip install -r requirements.txt

3.构建服务器

npm run build

4.配置MCP客户端

添加到您的MCP客户端配置中(例如,Claude Desktop):

窗户:

{
  "mcpServers": {
    "kicad": {
      "command": "node",
      "args": ["C:\\path\\to\\kicad_mcp\\dist\\server.js"],
      "env": {
        "KICAD_PATH": "C:\\Program Files\\KiCad\\8.0\\bin"
      }
    }
  }
}

Linux/macOS:

{
  "mcpServers": {
    "kicad": {
      "command": "node",
      "args": ["/path/to/kicad_mcp/dist/server.js"],
      "env": {
        "KICAD_PATH": "/usr/bin"
      }
    }
  }
}

🎓 快速开始

2分钟内您的第一块PCB

1. "Create a new project called HelloPCB"
2. "Set board size to 50mm x 50mm"
3. "Place an ESP32-C3 at the center"
4. "Add an LED with 330Ω resistor"
5. "Connect GPIO2 to the LED through the resistor"
6. "Run DRC"
7. "Export Gerber files"

完成! 你刚刚用自然语言设计了一个PCB。 🎊


📚 文档


🎯 用例

快速原型制作

在几分钟而不是几小时内设计简单的电路:

Design a voltage divider with 10k and 5k resistors on a 30x20mm board

生产PCB

使用JLCPCB集成创建制造就绪板:

Create a sensor board using only JLCPCB basic parts, export with assembly files

学习

在不记忆KiCAD界面的情况下探索PCB设计:

Show me how to create a 4-layer board with impedance-controlled traces

批量操作

自动化重复性任务:

Place 20 decoupling capacitors in a grid pattern near all ICs

🛠️ 可用工具(共59个)

分类

  1. 项目 (4个工具)-创建、打开、保存、获取信息
  2. 板 (9个工具)-图层、大小、孔、区域、可视化
  3. 组件 (10个工具)-放置、移动、旋转、删除、搜索、分组
  4. 原理图 (8个工具)-组件、接线、网络、网表
  5. 路由 (4个工具)-迹线、通孔、网、铜浇注
  6. 刚果民主共和国 (8个工具)-设计规则、验证、间隙检查
  7. 出口 (8个工具)-Gerber、BOM、PDF、3D、位置文件
  8. 图书馆 (8个工具)-符号/足迹搜索、JLCPCB集成

最常用的工具

- create_project
- place_component
- route_trace
- run_drc
- export_gerber
- search_symbols
- add_schematic_component
- get_board_2d_view

🌟 示例提示

简单

Create a 100x80mm board
Add an LED at position (50, 40)mm
Route a trace from R1 to C1
Show me the board

复杂

Design a USB-powered ESP32 board with voltage regulator,
4 status LEDs, I2C sensor connector, and mounting holes,
optimized for JLCPCB assembly

批量操作

Place ten 0.1µF capacitors near each IC for decoupling
Add test points for all power nets
Export complete manufacturing package (Gerbers, BOM, positions)

🔌 JLCPCB集成

以真实价格和库存访问100000多种组件:

# Set up API keys (optional, for database download)
export JLCPCB_API_KEY="your_key"
export JLCPCB_API_SECRET="your_secret"

用法

Download JLCPCB parts database
Search JLCPCB for "STM32F103" with basic parts only
Get pricing for LCSC part C2286
Find cheaper alternative to current resistor

优点:

  • 成本优化(基本零件=自由装配)
  • 实时库存检查
  • 使用LCSC编号自动生成BOM

🏗️ 建筑

┌─────────────────┐
│   AI Assistant  │  (Claude, etc.)
└────────┬────────┘
         │ MCP Protocol
┌────────▼────────┐
│   MCP Server    │  (TypeScript/Node.js)
│   (Router)      │
└────────┬────────┘
         │ JSON-RPC
┌────────▼────────┐
│ Python Backend  │  (KiCAD API)
│  (SWIG/IPC)     │
└────────┬────────┘
         │ Python API
┌────────▼────────┐
│     KiCAD       │  (PCB Design Software)
└─────────────────┘

🤝 贡献

欢迎投稿!需要改进的地方:

  • 其他导出格式
  • 更多库集成
  • 自动路由算法
  • 设计规则模板
  • 组件库

📄 许可证

MIT许可证-请参阅 许可证 文件


🙏 致谢

  • KiCAD开发团队
  • 人类MCP框架
  • JLCPCB用于零件数据库
  • 开源PCB设计社区

🐛 已知问题

  • 足迹搜索可能返回不完整的结果(已修复)
  • 实时模式需要KiCAD UI运行
  • JLCPCB数据库下载需要API证书

看 故障排除.md 解决方案。


📞 支持

  • 问题: https://github.com/LIsha-P-BNC/kicad_mcp/issues
  • 讨论: https://github.com/LIsha-P-BNC/kicad_mcp/discussions
  • 文档: 看 /docs 文件夹

🗺️ 路线图

  • []自动路由集成
  • []更多制造商集成(DigiKey、Mouser)
  • []PCB成本估算
  • []设计模板库
  • []多板项目
  • []仿真集成

⚡ 演出

  • 典型操作延迟:<500ms
  • 组件搜索:<100ms
  • 100元件板上的DRC:<2s
  • Gerber出口:<1s

由以下材料制成❤️ PCB设计社区

通过与您的AI助手交谈来设计PCB。就是这么简单。


快速链接: