适合谁
- 使用 KiCad 9.0+ 进行 PCB/硬件设计的工程师
- 希望在 Claude Desktop 等 MCP 客户端中用自然语言查询设计数据的用户
- 需要跨 macOS、Windows、Linux 工作的团队
K
56FMRS · C
一个文档完善、结构清晰的社区 KiCad MCP 服务器，功能覆盖项目管理、分析、BOM、DRC、可视化和模式识别，适合在 Claude Desktop 等 MCP 客户端中用自然语言操作 KiCad 设计，但需要本地 Python/uv 环境和手动配置，且非官方产品。
KiCad MCP Server 是一个面向 KiCad 的 Model Context Protocol 服务器，支持 macOS、Windows 和 Linux。它将 KiCad 项目管理、PCB 分析、网表提取、BOM 管理、DRC 检查、PCB 可视化和电路模式识别等能力暴露给任意兼容 MCP 的客户端（如 Claude Desktop），让用户可以用自然语言与自己的硬件设计项目交互。该项目要求 Python 3.10+、KiCad 9.0+、uv 0.8.0+，采用模块化结构（resources/tools/prompts/utils），以 MIT 许可证开源，由社区维护，并非 KiCad 官方产品。
工具能力
open_project
启动 KiCad 并打开指定的项目
安装接入
1) git clone https://github.com/lamaalrajih/kicad-mcp.git 并进入目录；2) 先安装 uv（brew install uv 或 pipx install uv），然后运行 make install 自动创建 .venv 并安装依赖；3) 复制 .env.example 为 .env，配置 KICAD_SEARCH_PATHS（逗号分隔的 KiCad 项目目录）、可选 KICAD_USER_DIR 和 KICAD_APP_PATH；4) 运行 python main.py 启动服务器；5) 在 Claude Desktop 配置文件（如 ~/Library/Application Support/Claude/claude_desktop_config.）的 mcpServers 中添加 kicad 条目，command 指向 .venv/bin/python 的绝对路径，args 指向 main.py 的绝对路径；6) 重启 MCP 客户端。
claude_desktop_config.json
{"mcpServers":{"kicad":{"command":"/ABSOLUTE/PATH/TO/YOUR/PROJECT/kicad-mcp/.venv/bin/python","args":["/ABSOLUTE/PATH/TO/YOUR/PROJECT/kicad-mcp/main.py"]}}}
选型与风险
不适合谁
- 不使用 KiCad 或使用低于 9.0 版本的用户
- 没有 Python 3.10+ 和 uv 环境的用户
- 期待一键安装、无需本地配置的用户
所需权限
- 读取本机 KiCad 项目目录（由 KICAD_SEARCH_PATHS 等环境变量指定）
- 读取 KiCad 项目、原理图和 PCB 文件
- 调用 KiCad CLI 执行 DRC 等操作
- 启动 KiCad 应用程序
- 生成可视化缩略图和导出文件（如 BOM）
风险与副作用
- 服务器可读取本机设计文件，项目搜索路径配置过宽可能暴露无关文件
- 部分工具具有副作用（打开应用、生成文件），调用前应有用户确认
- 需要社区维护，可能存在 bug 或与 KiCad 新版本不兼容
- 客户端配置中必须使用绝对路径，否则可能因工作目录未定义而失败
常见排障
- 服务器未出现在客户端：检查配置文件 JSON 格式及 Python 解释器、main.py 的绝对路径是否正确
- 确认 Python 环境中可访问 mcp 包
- 确认本机 KiCad 安装被正确检测到
- 查看服务器日志：~/Library/Logs/Claude/mcp-server-kicad.log 和 ~/Library/Mcp.log（macOS 下 Claude 日志目录）
- 在配置文件和 .env 中始终使用绝对路径，避免工作目录未定义的问题
- 仍无法解决时可在 GitHub 上提交 issue
使用场景
按修改时间列出并打开最近的 KiCad 项目
分析 PCB 的元件密度与间距
从原理图提取元件连接关系（网表）
生成和导出物料清单（BOM）
通过 KiCad CLI 运行 DRC 并跟踪违规修复进度
生成 PCB 布局的缩略图可视化
识别原理图中的电源拓扑等常见电路模式
支持客户端
Claude Desktop完整支持