thalisantunes/mcp-kicad
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
MCP server para KiCad 10 — IPC API (kipy) + kicad-cli, com regras de fabricação JLCPCB embutidas
概要
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): - — caminho primário. Headless, sem precisar do KiCad aberto, cobre esquemático e todo o export. - — 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 . 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 , 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. Duas formas, ambas instalam o KiCad 10 em /Applications/KiCad: - o DMG oficial, universal (Intel e Apple Silicon, ~1,4 GB), em kicad.
README
以下は原文 README の抜粋です。原文を見る。
mcp-kicad
Nota sobre o nome no PyPI: o pacote é distribuído como
mcp-kicad10. O nomemcp-kicadno PyPI pertence a daedalus/mcp-kicad, um projeto diferente. O módulo importável continuamcp_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
kicaddo 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.
インストール
This server does not publish a one-line install command.
Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →設定
{
"mcpServers": {
"kicad": {
"command": "/opt/homebrew/bin/uv",
"args": ["--directory", "/Users/SEU_USUARIO/mcp-kicad", "run", "mcp-kicad"]
}
}
}