oaslananka-lab/kicad-mcp-pro

O que kicad-mcp-pro faz?

Servidor MCP para KiCad 10/9 — captura de esquemas, layout de PCB, DRC/ERC/DFM, integridade de sinal e potência, EMC, simulação SPICE, FreeRouting e exportações Gerber/BOM/IPC-2581/STEP via agentes de IA.

Visão Geral

Este servidor permite que agentes de IA interajam diretamente com o KiCad, automatizando tarefas de design eletrônico. Ele suporta:

• Captura de esquemas elétricos
• Layout de PCB
• DRC (Design Rule Check)
• ERC (Electrical Rule Check)
• DFM (Design for Manufacturing)
• Análise de integridade de sinal e potência
• Análise de compatibilidade eletromagnética (EMC)
• Simulação SPICE
• Roteamento automático via FreeRouting
• Exportações Gerber, BOM, IPC-2581 e STEP

Requisitos

• KiCad 10 ou 9 instalado
• Node.js 18+ (para executar o servidor MCP)
• Acesso à internet (para download de bibliotecas, se necessário)

Instalação

1. Clone o repositório:

git clone https://github.com/oaslananka-lab/kicad-mcp-pro.git
cd kicad-mcp-pro

2. Instale as dependências:

npm install

3. Configure as variáveis de ambiente (opcional):

export KICAD_MCP_PORT=3000
export KICAD_PATH=/usr/local/bin/kicad

4. Inicie o servidor:

npm start

Uso com Agentes de IA

Exemplo de Comandos

# Criar um novo projeto PCB
mcp_call create_project nome_do_projeto

# Carregar um esquema existente
mcp_call load_schematic caminho/para/arquivo.sch

# Executar verificação DRC
mcp_call run_drc

# Exportar Gerber
mcp_call export_gerber pasta_de_saida

# Simular circuito com SPICE
mcp_call run_spice netlist.cir

Integração com Claude Code

Adicione ao seu arquivo de configuração .claude-code/config.json:

{
  "mcpServers": {
    "kicad-mcp-pro": {
      "command": "node",
      "args": ["caminho/para/kicad-mcp-pro/index.js"],
      "env": {
        "KICAD_MCP_PORT": "3000"
      }
    }
  }
}

API do Servidor

Esquemas

• create_schematic(nome) - Cria um novo esquema
• add_component(ref, valor, pacote) - Adiciona um componente
• connect_pins(ref1, pino1, ref2, pino2) - Conecta pinos
• annotate_schematic() - Anota referências automaticamente
• run_erc() - Executa verificação ERC

PCB

• open_pcb(caminho) - Abre um layout PCB existente
• place_component(ref, x, y, rotacao) - Posiciona componente
• route_track(net_name, pontos) - Roteia trilha
• run_drc() - Executa verificação DRC
• run_dfm_check() - Executa verificação DFM

Análises

• signal_integrity(net_list) - Analisa integridade de sinal
• power_integrity(net_list) - Analisa integridade de potência
• emc_analysis(parameters) - Executa análise EMC
• run_spice(netlist, simulacao) - Executa simulação SPICE

Exportações

• export_gerber(pasta_destino) - Exporta arquivos Gerber
• export_bom(pasta_destino) - Exporta Bill of Materials (BOM)
• export_ipc2581(pasta_destino) - Exporta IPC-2581
• export_step(pasta_destino) - Exporta modelo STEP 3D

Estrutura do Projeto

kicad-mcp-pro/
├── src/
│   ├── index.js          # Ponto de entrada do servidor
│   ├── handlers/         # Manipuladores de comandos
│   ├── kicad-bridge/     # Interface com KiCad
│   └── utils/            # Utilitários
├── config/               # Arquivos de configuração
├── examples/             # Exemplos de uso
└── README.md             # Este arquivo

Contribuição

Contribuições são bem-vindas! Por favor, leia o guia de contribuição antes de enviar pull requests.

Licença

Este projeto está licenciado sob a licença MIT. Veja o arquivo LICENSE para detalhes.