如何5分钟让Claude连接KiCadKiCAD MCP Server三大平台安装完整教程Linux/Windows/macOS【免费下载链接】KiCAD-MCP-ServerKiCAD MCP is a Model Context Protocol (MCP) implementation that enables Large Language Models (LLMs) like Claude to directly interact with KiCAD for printed circuit board design.项目地址: https://gitcode.com/gh_mirrors/ki/KiCAD-MCP-ServerKiCAD MCP Server是一个基于模型上下文协议Model Context Protocol的 MCP 服务器它能让 Claude 等 AI 助手直接操控 KiCad 完成 PCB 设计画原理图、摆放元件、自动布线、查询 JLCPCB 元件库……你只需要用自然语言下指令服务器就把它们翻译成 KiCad 操作。本文带你用最短步骤在 Linux、Windows、macOS 三大平台上完成安装与连接全程大约 5 分钟。一、安装前准备确认三大依赖三个平台都需要准备以下环境缺什么补什么依赖要求说明KiCad9.0 及以上推荐 10提供pcbnewPython 模块Node.js20.x 及以上运行 MCP 服务器主体Python随 KiCad 自带加载 KiCad 模块无需额外安装 小贴士KiCad 自带的 Python 是 MCP Server 读取板卡的关键macOS 上必须使用 KiCad 捆绑的 Python系统 Python 会导致启动失败。二、克隆仓库所有平台通用10 秒完成在终端中执行git clone --branch stable https://gitcode.com/gh_mirrors/ki/KiCAD-MCP-Server.git cd KiCAD-MCP-Server注意请克隆stable分支它只随正式版本更新main分支可能包含未发布的修复。接下来按你的系统选择对应章节。三、Linux 安装步骤Ubuntu/Debian一键脚本推荐自动完成 KiCad、Node.js、依赖安装和构建bash scripts/install-linux.sh手动安装只需四步# 1. 安装 KiCad 9.0 sudo add-apt-repository --yes ppa:kicad/kicad-9.0-releases sudo apt-get update sudo apt-get install -y kicad kicad-libraries # 2. 安装 Node.js 20 curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs # 3. 安装依赖并构建 npm install pip3 install -r requirements.txt npm run build构建成功后会生成dist/index.js这就是 Claude 将要调用的入口文件。四、Windows 安装步骤一个脚本搞定Windows 提供了自动安装脚本 setup-windows.ps1它会依次完成检测 KiCad包括C:\Program Files\KiCad和%LOCALAPPDATA%\Programs\KiCad两种安装位置、校验 Python 与 Node.js、测试pcbnew模块、安装依赖、构建项目、自动生成 Claude Desktop 配置并运行诊断。git clone --branch stable https://gitcode.com/gh_mirrors/ki/KiCAD-MCP-Server.git cd KiCAD-MCP-Server .\setup-windows.ps1如需配合 VSCode 的 Cline 插件使用可以加参数.\setup-windows.ps1 -ClientType cline⚠️ 如果 PowerShell 禁止运行脚本先在终端执行Set-ExecutionPolicy -Scope CurrentUser RemoteSigned。安装失败时可查阅 docs/WINDOWS_TROUBLESHOOTING.md。五、macOS 安装步骤注意使用 KiCad 捆绑 PythonmacOS 的关键是必须用 KiCad 自带的 Python 创建虚拟环境否则服务器会静默启动失败# 1. 安装 Node.jsHomebrew brew install node20 # 2. 用 KiCad 捆绑的 Python 创建虚拟环境 /Applications/KiCad/KiCad.app/Contents/Frameworks/Python.framework/Versions/Current/bin/python3 -m venv venv --system-site-packages source venv/bin/activate # 3. 安装依赖并构建 npm install pip install -r requirements.txt npm run build构建完成后再运行自动配置脚本 setup-macos.sh它会检测环境、解析PYTHONPATH并把配置安全合并进 Claude Desktop自动备份原配置./setup-macos.sh --dry-run # 先预览不改动任何文件 ./setup-macos.sh --apply # 确认后应用六、配置 Claude Desktop三大平台配置路径速查如果上面的脚本没有自动生成配置手动编辑 Claude Desktop 的配置文件即可各平台位置如下Linux~/.config/Claude/claude_desktop_config.jsonmacOS~/Library/Application Support/Claude/claude_desktop_config.jsonWindows%APPDATA%\Claude\claude_desktop_config.json以 Linux 为例在mcpServers中加入参考 config/claude-desktop-config.json{ mcpServers: { kicad: { command: node, args: [/home/你的用户名/KiCAD-MCP-Server/dist/index.js], env: { PYTHONPATH: /usr/lib/kicad/lib/python3/dist-packages, NODE_ENV: production } } } }各平台PYTHONPATH常见取值平台PYTHONPATHLinux/usr/lib/kicad/lib/python3/dist-packagesWindowsC:\Program Files\KiCad\9.0\bin\Lib\site-packages注意用双反斜杠\\macOS标准安装无需配置服务器会自动检测/Applications/KiCad/完整配置参考 docs/CLIENT_CONFIGURATION.md。七、验证连接是否成功彻底退出Claude Desktop不是关窗口再重新打开开始新对话点击 → Connectors应能看到kicad服务器输入测试指令例如Use the kicad MCP server to run check_kicad_ui正常会返回 KiCad UI 状态。也可以在终端手动启动服务器自检看到Successfully connected to STDIO transport即代表构建无误node dist/index.js八、常见问题快速排查现象原因与解决Cannot find module pcbnewPYTHONPATH指向错误按上表修正后重启 ClaudeClaude 30 秒超时、无报错macOS依赖装到了系统 Python改用 KiCad 捆绑 Python 重新安装找不到dist/index.js在仓库目录重新执行npm run build配置语法错误用jq . 配置文件路径校验 JSON 格式更多细节见 docs/PLATFORM_GUIDE.md 与 docs/KNOWN_ISSUES.md。写在最后完成以上步骤后你的 Claude 就拥有了 180 个 KiCad 工具原理图绘制、PCB 布局、Freerouting 自动布线、JLCPCB 250 万 元件查询等。以后升级版本只需在仓库目录执行git pull npm install npm run build三步即可。把电路板设计交给 AI你只需要负责提需求【免费下载链接】KiCAD-MCP-ServerKiCAD MCP is a Model Context Protocol (MCP) implementation that enables Large Language Models (LLMs) like Claude to directly interact with KiCAD for printed circuit board design.项目地址: https://gitcode.com/gh_mirrors/ki/KiCAD-MCP-Server创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
如何5分钟让Claude连接KiCad：KiCAD MCP Server三大平台安装完整教程（Linux/Windows/macOS）
如何5分钟让Claude连接KiCadKiCAD MCP Server三大平台安装完整教程Linux/Windows/macOS【免费下载链接】KiCAD-MCP-ServerKiCAD MCP is a Model Context Protocol (MCP) implementation that enables Large Language Models (LLMs) like Claude to directly interact with KiCAD for printed circuit board design.项目地址: https://gitcode.com/gh_mirrors/ki/KiCAD-MCP-ServerKiCAD MCP Server是一个基于模型上下文协议Model Context Protocol的 MCP 服务器它能让 Claude 等 AI 助手直接操控 KiCad 完成 PCB 设计画原理图、摆放元件、自动布线、查询 JLCPCB 元件库……你只需要用自然语言下指令服务器就把它们翻译成 KiCad 操作。本文带你用最短步骤在 Linux、Windows、macOS 三大平台上完成安装与连接全程大约 5 分钟。一、安装前准备确认三大依赖三个平台都需要准备以下环境缺什么补什么依赖要求说明KiCad9.0 及以上推荐 10提供pcbnewPython 模块Node.js20.x 及以上运行 MCP 服务器主体Python随 KiCad 自带加载 KiCad 模块无需额外安装 小贴士KiCad 自带的 Python 是 MCP Server 读取板卡的关键macOS 上必须使用 KiCad 捆绑的 Python系统 Python 会导致启动失败。二、克隆仓库所有平台通用10 秒完成在终端中执行git clone --branch stable https://gitcode.com/gh_mirrors/ki/KiCAD-MCP-Server.git cd KiCAD-MCP-Server注意请克隆stable分支它只随正式版本更新main分支可能包含未发布的修复。接下来按你的系统选择对应章节。三、Linux 安装步骤Ubuntu/Debian一键脚本推荐自动完成 KiCad、Node.js、依赖安装和构建bash scripts/install-linux.sh手动安装只需四步# 1. 安装 KiCad 9.0 sudo add-apt-repository --yes ppa:kicad/kicad-9.0-releases sudo apt-get update sudo apt-get install -y kicad kicad-libraries # 2. 安装 Node.js 20 curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs # 3. 安装依赖并构建 npm install pip3 install -r requirements.txt npm run build构建成功后会生成dist/index.js这就是 Claude 将要调用的入口文件。四、Windows 安装步骤一个脚本搞定Windows 提供了自动安装脚本 setup-windows.ps1它会依次完成检测 KiCad包括C:\Program Files\KiCad和%LOCALAPPDATA%\Programs\KiCad两种安装位置、校验 Python 与 Node.js、测试pcbnew模块、安装依赖、构建项目、自动生成 Claude Desktop 配置并运行诊断。git clone --branch stable https://gitcode.com/gh_mirrors/ki/KiCAD-MCP-Server.git cd KiCAD-MCP-Server .\setup-windows.ps1如需配合 VSCode 的 Cline 插件使用可以加参数.\setup-windows.ps1 -ClientType cline⚠️ 如果 PowerShell 禁止运行脚本先在终端执行Set-ExecutionPolicy -Scope CurrentUser RemoteSigned。安装失败时可查阅 docs/WINDOWS_TROUBLESHOOTING.md。五、macOS 安装步骤注意使用 KiCad 捆绑 PythonmacOS 的关键是必须用 KiCad 自带的 Python 创建虚拟环境否则服务器会静默启动失败# 1. 安装 Node.jsHomebrew brew install node20 # 2. 用 KiCad 捆绑的 Python 创建虚拟环境 /Applications/KiCad/KiCad.app/Contents/Frameworks/Python.framework/Versions/Current/bin/python3 -m venv venv --system-site-packages source venv/bin/activate # 3. 安装依赖并构建 npm install pip install -r requirements.txt npm run build构建完成后再运行自动配置脚本 setup-macos.sh它会检测环境、解析PYTHONPATH并把配置安全合并进 Claude Desktop自动备份原配置./setup-macos.sh --dry-run # 先预览不改动任何文件 ./setup-macos.sh --apply # 确认后应用六、配置 Claude Desktop三大平台配置路径速查如果上面的脚本没有自动生成配置手动编辑 Claude Desktop 的配置文件即可各平台位置如下Linux~/.config/Claude/claude_desktop_config.jsonmacOS~/Library/Application Support/Claude/claude_desktop_config.jsonWindows%APPDATA%\Claude\claude_desktop_config.json以 Linux 为例在mcpServers中加入参考 config/claude-desktop-config.json{ mcpServers: { kicad: { command: node, args: [/home/你的用户名/KiCAD-MCP-Server/dist/index.js], env: { PYTHONPATH: /usr/lib/kicad/lib/python3/dist-packages, NODE_ENV: production } } } }各平台PYTHONPATH常见取值平台PYTHONPATHLinux/usr/lib/kicad/lib/python3/dist-packagesWindowsC:\Program Files\KiCad\9.0\bin\Lib\site-packages注意用双反斜杠\\macOS标准安装无需配置服务器会自动检测/Applications/KiCad/完整配置参考 docs/CLIENT_CONFIGURATION.md。七、验证连接是否成功彻底退出Claude Desktop不是关窗口再重新打开开始新对话点击 → Connectors应能看到kicad服务器输入测试指令例如Use the kicad MCP server to run check_kicad_ui正常会返回 KiCad UI 状态。也可以在终端手动启动服务器自检看到Successfully connected to STDIO transport即代表构建无误node dist/index.js八、常见问题快速排查现象原因与解决Cannot find module pcbnewPYTHONPATH指向错误按上表修正后重启 ClaudeClaude 30 秒超时、无报错macOS依赖装到了系统 Python改用 KiCad 捆绑 Python 重新安装找不到dist/index.js在仓库目录重新执行npm run build配置语法错误用jq . 配置文件路径校验 JSON 格式更多细节见 docs/PLATFORM_GUIDE.md 与 docs/KNOWN_ISSUES.md。写在最后完成以上步骤后你的 Claude 就拥有了 180 个 KiCad 工具原理图绘制、PCB 布局、Freerouting 自动布线、JLCPCB 250 万 元件查询等。以后升级版本只需在仓库目录执行git pull npm install npm run build三步即可。把电路板设计交给 AI你只需要负责提需求【免费下载链接】KiCAD-MCP-ServerKiCAD MCP is a Model Context Protocol (MCP) implementation that enables Large Language Models (LLMs) like Claude to directly interact with KiCAD for printed circuit board design.项目地址: https://gitcode.com/gh_mirrors/ki/KiCAD-MCP-Server创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
![10.1[A]](http://pic.xiahunao.cn/yaotu/10.1[A])
