KiCad MCP 服务器集成

“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

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

6. 重启 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 服务器地址。

概览

我们的看法

本 MCP 服务器为 KiCad 与 LLM 客户端之间提供了基础集成，重点在于资源共享与项目发现，但缺少更成熟 MCP 服务器中常见的高级提示与工具自定义。其文档对配置说明清晰，但面向开发者的高级特性较少。

MCP 评分

基于上述表格，我会给该 MCP 服务器打 4/10：安装简便，适合特定需求，但缺乏可扩展性及工具、提示、采样等成熟 MCP 特性。