Token导航 LogoToken导航TokenDH.com
AG
设计创作未说明官方级别未说明来源级核验

Agent Kicad Pipeline

MCP Server

KiCad 9.0 PCB设计自动化工具,提供FastMCP服务器和Agent Zero技能,支持多代理协作,适用于PCB设计流程。

工具数

8

提示词数

0

GitHub Stars

0

资源数

0
多代理协作PythonClaudeFastMCPClaude DesktopClaudeCursor

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

作者 / 组织

Wookie1

提供方

Wookie1

最后核验

2026/5/17 20:23

快速接入

先看主来源和安装命令,再打开仓库或文档;下面只保留这个条目的关键接入事实。

详细介绍

代理kicad管道

KiCad 9.0用于AI代理的PCB设计自动化。

提供 FastMCP服务器 (pcb-pipeline)它公开了八个高级工具,涵盖了整个PCB设计流程,以及一组 零号特工技能子代理配置文件 用于多代理编排。

适用于任何支持MCP的代理框架(agent Zero、Claude Desktop、Cursor等)。

______________________________________________________________________

里面是什么

agent-kicad-pipeline/
├── pcb-pipeline/                  FastMCP server — the core artifact
│   ├── pcb_pipeline_mcp.py        8 high-level MCP tools
│   ├── schematic_builder.py       Auto-layout schematic + netlist from component/net lists
│   ├── pcb_placer.py              Connectivity-aware footprint placement (no pcbnew needed)
│   ├── requirements.txt           fastmcp
│   └── settings-snippet.json      MCP server config block for Agent Zero settings.json
│
├── pcb-design-agents/             Agent Zero sub-agent profiles (5 consolidated agents)
│   ├── pcb-orchestrator/          Router: gathers requirements, calls pcb_init, manages gates
│   ├── pcb-schematic/             Calls pcb_schematic(components[], nets[]) — no coordinates
│   ├── pcb-layout-drc/            pcb_layout → DRC loop → pcb_route → post-DRC (full cycle)
│   ├── pcb-finalize/              Quality check + pcb_export (task: "quality" or "export")
│   └── pcb-vision-parts/          Vision-based part/footprint identification (optional)
│
├── kicad-project-init/            Skill: scaffold a new KiCad project
├── kicad-schematic-design/        Skill: schematic entry scripts
├── kicad-pcb-layout/              Skill: footprint placement scripts
├── kicad-route-pcb/               Skill: Freerouter auto-routing
├── kicad-run-drc/                 Skill: DRC checks
├── kicad-manufacturing-export/    Skill: Gerber / BOM / CPL / STEP export
├── kicad-create-custom-symbol/    Skill: custom symbol creation
├── kicad-create-custom-footprint/ Skill: custom footprint creation
├── kicad-import-dxf/              Skill: import DXF board outlines
│
├── install_pcb_pipeline.sh        Installer: copy + pip-install into Docker container
└── run_agent_zero.sh              Docker startup script (skills-venv, Xvfb, env vars)

______________________________________________________________________

pcb流水线MCP工具

工具输入它的作用
pcb_init项目名称、板尺寸、工厂创建项目脚手架(dirs, .kicad_pro,占位符示意图)
pcb_schematiccomponents[], nets[]自动放置符号,生成 .kicad_sch + .net无需坐标
pcb_search_lib查询,类型搜索符号/封装库,返回 lib_id 准备使用的字符串
pcb_layout项目目录,可选提示导入网表→ PCB,运行连接感知足迹放置
pcb_route项目目录通过Freerouter JAR自动路由
pcb_drc项目目录运行KiCad DRC,返回结构化违规列表
pcb_export项目目录,工厂导出Gerbers、钻孔、BOM、CPL、原理图PDF、PCB PDF、STEP
pcb_status项目目录返回当前阶段、文件列表和统计信息

为什么使用管道服务器而不是单个MCP调用?

生的 kicad-mcp 工具需要30-50多次单独调用才能完成一个完整的电路板,并暴露出几个可靠性陷阱:

  • run_erc KiCad 9上的无头分段故障(SIGSEGV)
  • update_pcb_from_schematic 在没有实时显示的情况下发生故障
  • pcbnew.LoadBoard() 悄无声息地回来了 None 没有 DISPLAY=:99
  • 代理必须在每次呼叫时手动计算组件坐标

管道服务器在服务器端处理所有环境复杂性。代理人描述 *什么* 建设;服务器知道了 *怎么*.

______________________________________________________________________

快速启动

先决条件(Docker容器)

  • KICAD 9.0(apt-get install kicad 在Kali Linux上)
  • Javaapt-get install default-jre-headless)--Freerouter需要
  • 自由路由JAR /a0/usr/freerouting/freerouting.jar
  • Xvfb持续打开 :99 (开始于 run_agent_zero.sh)
  • Agent Zero Docker镜像: agent0ai/agent-zero:latest

安装MCP服务器

# From the macOS host — copies scripts into data volume, installs fastmcp
./install_pcb_pipeline.sh agent-zero

然后添加 pcb-pipeline 阻止来自 pcb-pipeline/settings-snippet.json 进入 mcp_servers JSON字符串 ~/agent-zero-data/settings.json:

"pcb-pipeline": {
  "type": "stdio",
  "command": "/a0/usr/skills-venv/bin/python3",
  "args": ["/a0/usr/tools/pcb-pipeline/pcb_pipeline_mcp.py"],
  "autoApprove": [],
  "env": {
    "KICAD_CLI_PATH":       "/usr/local/bin/kicad-cli-xvfb",
    "KICAD_SYMBOL_LIBS":    "/kicad-support/symbols",
    "KICAD_FOOTPRINT_LIBS": "/kicad-support/footprints",
    "FREEROUTING_JAR":      "/a0/usr/freerouting/freerouting.jar",
    "SKILLS_DIR":           "/a0/usr/skills"
  }
}

部署Agent Zero技能和配置文件

# Copy skills into the project
cp -r kicad-*/  ~/agent-zero-data/projects/pcb-design/.a0proj/skills/

# Copy sub-agent profiles
cp -r pcb-design-agents/*/  ~/agent-zero-data/projects/pcb-design/.a0proj/agents/

______________________________________________________________________

代理提示示例

Design a 3-channel LED driver board.

Components:
  U1  NE555 timer        Timer:NE555         Package_SO:SOIC-8_3.9x4.9mm_P1.27mm
  R1  10Ω resistor       Device:R            Resistor_SMD:R_0402_1005Metric
  R2  10Ω resistor       Device:R            Resistor_SMD:R_0402_1005Metric
  R3  10Ω resistor       Device:R            Resistor_SMD:R_0402_1005Metric
  D1  red LED            Device:LED          LED_SMD:LED_0603_1608Metric
  D2  red LED            Device:LED          LED_SMD:LED_0603_1608Metric
  D3  red LED            Device:LED          LED_SMD:LED_0603_1608Metric
  C1  100nF decoupling   Device:C            Capacitor_SMD:C_0402_1005Metric
  J1  2-pin connector    Connector:Conn_01x02 Connector_PinHeader_2.54mm:PinHeader_1x02

Nets:
  VCC  → U1.8, C1.1, J1.1
  GND  → U1.1, C1.2, R1.2, R2.2, R3.2, J1.2
  OUT  → U1.3, R1.1, R2.1, R3.1
  CH1  → R1.2, D1.A
  CH2  → R2.2, D2.A
  CH3  → R3.2, D3.A
  GND  → D1.K, D2.K, D3.K

Board: 50×40mm, target JLCPCB.

编排者通过示意图进行委派→ 布局→ 路线→ DRC → 出口,返回a fab/ 文件夹已准备好上传。

______________________________________________________________________

Docker环境

skills-venv/a0/usr/skills-venv/ 由创建 run_agent_zero.sh 并坚持 agent-zero-data 音量。它包含 fastmcp, ezdxf, svgwrite,以及 reportlab.

系统 python3/usr/bin/python3 提供 pcbnew (与KiCad软件包一起安装)。

关键环境变量:

KICAD_CLI_PATH=/usr/local/bin/kicad-cli-xvfb  # wrapper: DISPLAY=:99 exec kicad-cli
DISPLAY=:99                                    # persistent Xvfb (run_agent_zero.sh)
FREEROUTING_JAR=/a0/usr/freerouting/freerouting.jar

______________________________________________________________________

已知的限制和解决方法

问题此处使用的解决方法
run_erc KiCad 9上的SIGSEGV无头schematic_preflight.py 结构检查
update_pcb_from_schematic 无头失败sch_to_pcb_sync.py 字符串操作同步
export_bom_csv MCP工具损坏generate_bom.py 回退+从PCB文本中内联BOM
pcbnew.LoadBoard() 沉默 None所有pcbnew调用都使用 DISPLAY=:99 在子进程环境中
track_count 始终为0发布路线pcb_drc unconnected_count 用作路由完整性代理

______________________________________________________________________

安全说明

settings.json 文件被排除在外 .gitignore -它们可以包含模型API基础URL。 永不承诺 *.env, secrets.env,或任何 settings.json 文件夹。 API密钥存储在 ~/agent-zero-data/.env 在主机上,而不是在此存储库中。

______________________________________________________________________

许可证

麻省理工学院

目录标签

目录标签

多代理协作PythonClaudeFastMCPPCB设计本地部署自动化工具KiCad

支持客户端

Claude DesktopClaudeCursor

接入字段

传输方式(transport,传输协议)

未说明

鉴权方式(authType,认证方式)

none

工具数量(toolCount,工具数)

8

资源数量(resourceCount,资源数)

0

提示词数量(promptCount,提示词数)

0

权限和风险

未说明none部署方式未说明

接入前请确认传输方式、认证方式和部署位置,并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

仍需确认:installCommand

来源信息

继续浏览同类 MCP