KiCad MCP 服务器集成

将 KiCad EDA 与 FlowHunt 及 LLM 驱动的智能代理集成，实现更智能、跨平台的 PCB 项目管理与自动化设计流程。

AI EDA KiCad MCP Server

“KiCad” MCP 服务器的功能是什么？

KiCad MCP（模型上下文协议）服务器是一款旨在连接 AI 助手与 KiCad 电子设计自动化套件的工具。它作为中介，使 AI 客户端可以在 macOS、Windows 或 Linux 上访问和操作 KiCad 项目数据、文件和资源。这种集成通过支持项目发现、文件浏览和上下文共享等功能，极大提升了硬件与 PCB 开发流程的效率——所有操作都可通过 LLM 驱动的助手直接完成。KiCad MCP 服务器支持自然语言查询，使开发者和工程师能够更轻松地管理、访问和查询 KiCad 项目，从而简化复杂 PCB 设计的工作流程。

提示模板列表

仓库或文档中未提及具体的提示模板。

资源列表

KiCad 项目目录
- 提供对用户指定的包含 KiCad 项目的目录的访问。
PCB 设计文件
- 暴露 .kicad_pcb 及相关项目文件，便于 LLM 引用。
项目元数据
- 提供项目的元数据信息（如名称、路径、修改时间），便于上下文查询。

工具列表

在现有文档或服务器代码中未详细说明资源访问以外的显式工具。仓库中未找到工具定义。

该 MCP 服务器的应用场景

项目发现与搜索
开发者可以让 AI 助手在指定目录下搜索并列出所有 KiCad 项目，提高多硬件项目管理效率。
文件浏览与访问
AI 客户端可浏览、打开并引用 KiCad PCB 与原理图文件，简化复杂电路板设计的审阅或编辑流程。
为 LLM 共享上下文
使 LLM 能在设计讨论或故障排查时访问特定 KiCad 项目文件或元数据作为上下文。
与 MCP 客户端集成
与如 Claude Desktop 等工具无缝集成，实现自动化流程，例如生成摘要或提取项目信息。
跨平台 PCB 协作
方便团队在 Mac、Windows 与 Linux 间共享项目仓库，促进协同硬件开发。

如何进行设置

Windsurf

仓库中未找到 Windsurf 专用说明。通用 MCP 设置适用。

Claude

确保已安装 Python 3.10+、KiCad 9.0+ 及 Claude Desktop。
克隆仓库并创建 Python 虚拟环境。
使用 pip install -r requirements.txt 安装依赖。
编辑或新建 ~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"
      ]
    }
  }
}

重启 Claude Desktop 以激活配置。

Cursor

仓库中未找到 Cursor 专用说明。通用 MCP JSON 配置适用。

Cline

仓库中未找到 Cline 专用说明。通用 MCP JSON 配置适用。

保护 API 密钥
请在 .env 文件中使用环境变量存储敏感路径或凭据。例如：

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

在 JSON 配置中的用法示例（env 与 inputs）：

{
  "mcpServers": {
    "kicad": {
      "command": "...",
      "args": ["..."],
      "env": {
        "KICAD_SEARCH_PATHS": "~/pcb,~/Electronics"
      },
      "inputs": {}
    }
  }
}

如何在流程中使用该 MCP

FlowHunt 下的 MCP 使用

要将 MCP 服务器集成到 FlowHunt 工作流中，首先在流程中添加 MCP 组件，并将其连接到您的 AI 代理：

点击 MCP 组件打开配置面板。在系统 MCP 配置部分，按如下 JSON 格式填入您的 MCP 服务器信息：

{
  "kicad": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

配置完成后，AI 代理即可作为工具使用该 MCP，拥有其全部功能和能力。请根据实际情况将 “kicad” 替换为您的 MCP 服务器名称，并将 URL 替换为您自己的 MCP 服务器地址。

概览

部分	可用性	详情/备注
概览	✅	摘自 README.md 及项目简介
提示模板列表	⛔	未提及提示模板
资源列表	✅	KiCad 项目目录、PCB 文件、项目元数据
工具列表	⛔	未描述显式工具，仅提供资源访问
API 密钥安全	✅	通过 .env 与 JSON 配置说明
采样支持（评测中较次要）	⛔	未提及