Agent Kicad Pipeline

MCP设计创作

提供方 Wookie1

设计创作 未标注 无需鉴权 社区 / 第三方 Claude DesktopClaudeCursor

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

一句话选型结论

按资料字段整理

Agent Kicad Pipeline 属于设计创作类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude Desktop、Claude、Cursor,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类设计创作 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 8 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

设计创作
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量8暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

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

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 8 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
出图与素材

生成配图、图标与素材。

设计稿处理

读取设计稿、批量改尺寸或导出。

内容生成

按主题生成文案与视觉草稿。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 8 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在设计创作场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Agent Kicad Pipeline当前 8 未标注 未标注 无 2026-05-17
Cursor Talk To Figma MCP Da1c7911 40 未标注 未标注 无 2026-05-17
Blender MCP 17 stdio · 本地进程 本地部署 有 2026-05-18
Nova Canvas MCP Server 2 stdio · 本地进程 本地部署 有 2026-05-17
Figma Context MCP 3aaa8d28 未标注 未标注 支持远程部署 无 2026-05-17
kreuzberg 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

设计创作
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Wookie1上游标注的维护方 Wookie1
分类设计创作本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.1 KB
来自项目仓库与上游目录的原文,未做删改

代理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_schematic` | `components[]`, `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上)
- Java`apt-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服务器```bash
# 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:```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技能和配置文件```bash
# 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 在主机上,而不是在此存储库中。


许可证

麻省理工学院

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Agent Kicad Pipeline 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Agent Kicad Pipeline 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Agent Kicad Pipeline 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Agent Kicad Pipeline 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Agent Kicad Pipeline 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Agent Kicad Pipeline 能提供哪些能力?

资料显示约 8 个工具;能力标签包括 多代理协作、Python、Claude、FastMCP。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。