mcp-kicad

Name: mcp-kicad
Author: daedalus

本地服务

github.com/daedalus科研与教育027 周前更新

代码仓库

关于 mcp-kicad

mcp-kicad 通过 IPC API 将 MCP 服务连接到正在运行的 KiCad PCB Editor，提供电路板、封装、网络和项目检查工具，适用于 KiCad 9.0 及更高版本。

主要功能

01连接正在运行的 KiCad
02查看电路板信息和图层
03列出并搜索封装
04检查网络、区域、走线和过孔
05读取项目信息和版本

适用场景

01检查 PCB 图层和设计设置
02查找 KiCad 项目中的封装
03查看网络、走线和过孔

MCP 相关

该 MCP 服务将 KiCad PCB Editor 的 IPC API 操作作为工具提供给 MCP 客户端，包括电路板和项目检查。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "daedalus-mcp-kicad": {
      "command": "uvx",
      "args": [
        "mcp-kicad"
      ]
    }
  }
}

启动命令uvx mcp-kicad

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypimcp-kicad0.1.1stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
timeout_ms	integer	否	连接超时时间，单位为毫秒。默认值为 2000。
kicad_token	any	否	用于身份验证的可选 API 令牌。
socket_path	any	否	可选的 IPC 套接字路径。如果未提供，则从 KICAD_API_SOCKET 环境变量读取，或使用默认的平台路径。

详细介绍

mcp-kicad — 通过 IPC API 提供 KiCad PCB 编辑器功能的 MCP 服务。

安装

pip install mcp-kicad

要求

KiCad 9.0 或更高版本，并启用 IPC API 服务端
在 KiCad 中前往 Preferences > Plugins，启用 API 服务端

用法

MCP 服务通过 IPC API 与正在运行的 KiCad 实例通信。先启动 KiCad，再运行服务：

mcp-kicad

也可以在 MCP 客户端中配置：

{
  "mcpServers": {
    "mcp-kicad": {
      "command": "mcp-kicad",
      "env": {}
    }
  }
}

工具

该服务提供以下工具：

连接：connect_kicad、check_connection
电路板：get_board_info、get_layers、get_board_design_settings
封装：list_footprints、get_footprint、search_footprints
网络：list_nets、get_net、list_netclasses
区域：list_zones
走线/过孔：list_tracks、list_vias
焊盘：list_pads
文本：list_texts、get_text_extents
项目：get_project、get_version

示例

from mcp_kicad import mcp_server

# Connect to running KiCad
result = mcp_server.connect_kicad()

# Get board info
board_info = mcp_server.get_board_info()
print(board_info)

# List all footprints
footprints = mcp_server.list_footprints()
for fp in footprints:
    print(f"{fp['reference']}: {fp['value']}")

开发

git clone https://github.com/daedalus/mcp-kicad.git
cd mcp-kicad
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/

mcp-name: io.github.daedalus/mcp-kicad

支持 Markdown

登录后评论