Kicad MCP

🚀 KiCad MCP

KiCad MCP 是将 MCP 集成到 KiCad 中的项目，欢迎提交问题和拉取请求。它为 KiCad 带来了强大的 MCP 功能，提升了使用体验。

✨ 主要特性

• 开箱即用的完整 MCP 支持
• 内置 KiCad MCP 服务器

🚀 快速开始

1. 下载软件：下载 KiCad 华秋发行版 9.0.7-rc3 ，你也可以在 GitHub 发布页面 找到便携版。正式版本将随 KiCad 10 一起发布。
   • 安装建议：使用安装程序为用户安装，或者使用便携版并解压到可写目录。否则，在安装 Python 包时，KiCad MCP 服务器可能会因缺少写入权限而初始化失败。
2. 打开面板：打开 PCB 或原理图编辑器，点击“机器人”按钮以切换 Copilot 面板。
3. 配置设置：点击设置（齿轮）按钮，填写 OpenAI API Key 和 OpenAI Endpoint。应该有一个现有的内置 KiCad MCP 服务器可用。

🔧 技术细节

KiCad MCP 客户端

KiCad 客户端通过嵌入 mcp-agent 具备了完整的 MCP 功能。KiCad 编辑器（PCB/原理图）在启动时会自动启动一个 KiCad MCP 客户端 实例，并将双通信 IPC 通道和 KiCad IPC API URL 传递给它。

KiCad IPC API

KiCad IPC API 是 KiCad MCP 的核心，也是它与其他 MCP 客户端的区别所在。我们计划为其添加更多场景驱动的 API。如果你对开发 KiCad IPC API 感兴趣，可以查看 KiCad 或 KiCad 华秋电子发行版 的源代码。我们的分支始终与最新的 KiCad 发布分支保持同步，所有上游更改都会合并到其中。

KiCad MCP 服务器

KiCad MCP 服务器 基于官方 MCP Python SDK 将 KiCad IPC API 作为 MCP 工具公开。目前有 72 个工具 可用，未来还会添加更多。

前端

我们在 我们的服务器 上托管了 NextChat 作为前端。它通过 WebView IPC API 与 KiCad 交互，而 KiCad 则在 UI 和 mcp-agent 之间转发消息。

📦 安装指南

KiCad IPC API

请遵循 官方 KiCad 开发指南。

KiCad MCP 服务器

1. 找到本地 KiCad MCP 服务器的安装目录。
2. 克隆仓库并替换整个目录。

cd /path/to/kicad-installation-directory # 如果为用户安装，则为 %LOCALAPPDATA%\Programs\KiCad\9.0\bin
rm -rf ./kicad-mcp-server
git clone https://github.com/Huaqiu-Electronics/kicad-mcp-server.git

别忘了提交你的更改并打开拉取请求。

📚 详细文档

KiCad MCP 工具为空

如果你发现 KiCad MCP 工具为空，请按照以下步骤修复：

1. 确保安装目录可写。
2. 如果你为 Python pip 命令配置了镜像源，请确保该镜像源没有封禁你的 IP。MCP SDK 在首次启动时会拉取大量 Python 包。

启用新添加的 MCP 服务器

新的 MCP 服务器默认是禁用的，你可以通过点击输入框中附件图标旁边的按钮来检查并启用它们。