Nota sobre o nome no PyPI： o pacote é distribuído como mcp-kicad10. O nome mcp-kicad no PyPI pertence a daedalus/mcp-kicad， um projeto diferente.O módulo importável continua mcp_kicad.

MCP server para KiCad 10， com as regras de fabricação da JLCPCB embutidas.

Duas camadas de transporte， por decisão de arquitetura （ADR 0001）：

• kicad-cli — 首先出现。无头，sem precise do KiCad aberto， Cobre esquemático e todo o export.
• IPC API （kipy） — caminho secundário.Exige o PCB Editor aberto， serve Para inspecionar e mutar a sessão viva.

Nada de bindings SWIG do pcbnew： elas são removidas no KiCad 11.

Status： 16 tools.As de arquivo （DRC， ERC， export）， os perfis JLCPCB e o BOM/CPL com correção de rotação estão implementados e verificados contra o KiCad 10.0.5， nos testes de integração que rodam nos demos cm5_minima e complex_hierarchy。A camada IPC tem só board_summary e ainda não foi exercitada com um KiCad vivo — ver probe do nightly.

Instalar o KiCad

macOS

Duas formas， ambas instalam o KiCad 10 em /Applications/KiCad：

• o DMG 官方，通用（Intel 和 Apple Silicon，~1.4 GB），em kicad.org/download/macos;

mcp-kicad

Nota sobre o nome no PyPI: o pacote é distribuído como mcp-kicad10. O nome mcp-kicad no PyPI pertence a daedalus/mcp-kicad, um projeto diferente. O módulo importável continua mcp_kicad.

MCP server para KiCad 10, com as regras de fabricação da JLCPCB embutidas.

Duas camadas de transporte, por decisão de arquitetura (ADR 0001):

• kicad-cli — caminho primário. Headless, sem precisar do KiCad aberto, cobre esquemático e todo o export.
• IPC API (kipy) — caminho secundário. Exige o PCB Editor aberto, serve para inspecionar e mutar a sessão viva.

Nada de bindings SWIG do pcbnew: elas são removidas no KiCad 11.

Status: 17 tools (a 17ª é validate). As de arquivo (DRC, ERC, export), os perfis JLCPCB e o BOM/CPL com correção de rotação estão implementados e verificados contra o KiCad 10.0.5, nos testes de integração que rodam nos demos cm5_minima e complex_hierarchy. A camada IPC tem só board_summary e ainda não foi exercitada com um KiCad vivo — ver probe do nightly.

Instalar o KiCad

macOS

Duas formas, ambas instalam o KiCad 10 em /Applications/KiCad:

• o DMG oficial, universal (Intel e Apple Silicon, ~1,4 GB), em kicad.org/download/macos;
• brew install --cask kicad.

O kicad-cli fica dentro do app:

/Applications/KiCad/KiCad.app/Contents/MacOS/kicad-cli

Com o cask do Homebrew existe um symlink dele no PATH; com o DMG não. Não precisa configurar nada: o servidor procura nesse caminho (e em ~/Applications/KiCad/...) sozinho quando o kicad-cli não está no PATH. Só defina MCP_KICAD_CLI quando houver mais de uma instalação e você quiser fixar qual delas o MCP usa.

Verificar:

/Applications/KiCad/KiCad.app/Contents/MacOS/kicad-cli version

Ubuntu

PPA oficial, KiCad 10.0.5 (build para Ubuntu 26.04 resolute):

sudo add-apt-repository --yes ppa:kicad/kicad-10.0-releases

sudo apt update && sudo apt install --yes kicad

Verificar:

kicad-cli version

O kicad do repositório universe do Ubuntu 26.04 é 9.0.8 — funciona, mas perde time-domain tuning, editor gráfico de DRC e design variants do 10.

Flatpak

org.kicad.KiCad (também 10.0.5) instala sem sudo, mas o sandbox pode limitar o acesso a pastas de projeto fora do seu home. Aponte o servidor para ele:

export MCP_KICAD_CLI="flatpak run --command=kicad-cli org.kicad.KiCad"

Instalar o servidor

Precisa do uv (brew install uv no macOS).

git clone https://github.com/thalisantunes/mcp-kicad.git
cd mcp-kicad
uv sync

O uv sync é obrigatório antes de registrar: sem ele o primeiro start baixa as dependências e o cliente pode estourar o timeout de inicialização.