Sobre o projeto

KiCad MCP Pro é um servidor Model Context Protocol de código aberto criado para fluxos de trabalho do KiCad EDA, expondo ferramentas, recursos e prompts para automatizar design esquemático, layout de PCB, validação, verificações de design para fabricação e tarefas de exportação para fabricação para qualquer agente de IA compatível com MCP. O servidor usa divulgação progressiva para limitar o acesso padrão: ele começa com um perfil padrão delimitado que inclui 24 ferramentas de revisão somente leitura. Perfis adicionais desbloqueiam capacidades controladas: o perfil build habilita operações de edição controladas, o perfil release oferece suporte ao modo de fabricação com transferência condicionada por humanos, e o perfil expert/full é reservado para clientes avançados confiáveis. Telemetria e relatórios de erros são desativados por padrão, com configuração opcional de OpenTelemetry mediante adesão. O projeto se posiciona explicitamente como um assistente profissional de design e revisão de primeira passagem, não como uma autoridade autônoma de aprovação. As verificações ERC e DRC são executadas diretamente nos mecanismos nativos do KiCad; ferramentas integradas de integridade de sinal, integridade de energia, EMC e análise térmica são estimativas de forma fechada de primeira ordem com precisão típica de 5-10%, destinadas a revisão rápida de primeira passagem, e não como substitutas de solvers de campo 2D/3D, simulação EM/FEA ou aprovação formal de engenharia. O fornecimento de componentes ao vivo usa por padrão o catálogo público da JLCPCB, com integrações para Nexar, DigiKey e Mouser disponíveis apenas quando os usuários fornecem credenciais de API válidas. O servidor rastreia a paridade documentada de capacidade programática do KiCad em 76,6% por meio de uma matriz de paridade aberta e mantida que distingue lacunas reais de capacidade de recursos do KiCad que não têm API headless disponível. As opções de implantação incluem pacotes publicados no PyPI e npm, um aplicativo desktop Tauri que inicia automaticamente um painel web local em http://127.0.0.1:3334/ui, e uma CLI com comandos para inicialização, operação na bandeja do sistema, inicialização do painel e inicialização do servidor. Os protocolos de transporte suportados incluem stdio e Streamable HTTP, com operação sem estado por padrão para dar suporte a conectores que não exigem cabeçalhos de sessão; modo HTTP com estado opcional e fallback SSE legado estão disponíveis para compatibilidade com clientes mais antigos. O repositório inclui exemplos pré-construídos de configuração MCP para Claude Code, Codex CLI, VS Code/GitHub Copilot e OpenCode, além de definições de skills dedicadas para fluxos de trabalho centrais do KiCad, incluindo revisão de design, inspeção e roteamento de layout de PCB, execução e triagem de ERC/DRC, preparação de saída de fabricação e revisão esquemática. O projeto é licenciado sob MIT, com um processo reproduzível de bootstrap do código-fonte que instala toolchains locais fixadas por checksum sem modificar diretórios globais do sistema. Os requisitos de contribuição incluem passar por lint, format, typecheck, test, build e gates de segurança. Um site público de documentação cobre instalação, configuração de cliente, referência de ferramentas, fluxos de trabalho ponta a ponta, modelagem de ameaças de segurança e orientação de recuperação de erros, e releases arquivadas recebem um DOI permanente do Zenodo para citação acadêmica.