KiCad MCP Server

基本能力

产品定位

KiCad MCP Server 是一个为 KiCad 电子设计自动化软件设计的 Model Context Protocol (MCP) 服务器，旨在通过自然语言交互提升电子设计的工作效率。

核心功能

• 项目管理：列出、检查和打开 KiCad 项目
• PCB 设计分析：提供 PCB 设计和原理图的洞察
• 网络列表提取：从原理图中提取和分析组件连接
• BOM 管理：分析和导出材料清单
• 设计规则检查 (DRC)：运行 DRC 检查并跟踪进度
• PCB 可视化：生成 PCB 布局的视觉表示
• 电路模式识别：自动识别原理图中的常见电路模式

适用场景

• 电子设计师希望通过自然语言快速访问和管理 KiCad 项目
• 团队需要自动化 PCB 设计分析和报告生成
• 开发者希望集成 KiCad 功能到自定义 MCP 客户端中

工具列表

• Project Management：管理 KiCad 项目
• PCB Design Analysis：分析 PCB 设计
• Netlist Extraction：提取网络列表
• BOM Management：管理材料清单
• Design Rule Checking：执行设计规则检查
• PCB Visualization：可视化 PCB 布局
• Circuit Pattern Recognition：识别电路模式

常见问题解答

1. 服务器未出现在 MCP 客户端中：检查客户端配置文件中的路径是否正确
2. 服务器错误：检查终端输出或日志文件
3. 工作目录问题：确保在配置中使用绝对路径

使用教程

使用依赖

• macOS、Windows 或 Linux 系统，已安装 KiCad
• Python 3.10 或更高版本
• KiCad 9.0 或更高版本
• Claude Desktop 或其他 MCP 客户端
• 基本终端使用知识

安装教程

1. 设置 Python 环境

git clone https://github.com/lamaalrajih/kicad-mcp.git .
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

1. 配置环境

cp .env.example .env
vim .env

在 .env 文件中添加 KiCad 项目路径：

KICAD_SEARCH_PATHS=~/pcb,~/Electronics,~/Projects/KiCad

1. 运行服务器

python -m mcp.dev main.py
# 或
python main.py

1. 配置 MCP 客户端 编辑 Claude Desktop 配置文件：

mkdir -p ~/Library/Application\ Support/Claude
vim ~/Library/Application\ Support/Claude/claude_desktop_config.json

添加 KiCad MCP 服务器配置：

{
    "mcpServers": {
        "kicad": {
            "command": "/ABSOLUTE/PATH/TO/YOUR/PROJECT/kicad-mcp/venv/bin/python",
            "args": [
                "/ABSOLUTE/PATH/TO/YOUR/PROJECT/kicad-mcp/main.py"
            ]
        }
    }
}

1. 重启 MCP 客户端

调试方式

• 检查终端输出
• 查看日志文件：
• ~/Library/Logs/Claude/mcp-server-kicad.log
• ~/Library/Logs/Claude/mcp.log

许可证

该项目遵循 MIT 开源许可条款。