PCB Forge MCP
Provides tools for validating and exporting KiCad electronic design projects through kicad-cli, running ERC/DRC checks, verifying netlists, and generating manufacturing outputs such as Gerber files, drill files, STEP models and BOMs.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@PCB Forge MCP create a workspace and generate a KiCad project for a 3.3V LED blinker"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
PCB Forge
Sistema multiagente para transformar requisitos en lenguaje natural en proyectos electrónicos KiCad, con circuit-synth como motor de diseño y MCP como interfaz de herramientas.
Estado
Fundación inicial del repositorio. La estructura y los contratos básicos están implementados; la integración real con versiones concretas de circuit-synth y KiCad debe verificarse en el entorno destino antes de considerar los proyectos aptos para fabricación.
Related MCP server: Coppermind
Arquitectura
Servidor MCP: publica herramientas de generación, validación y exportación.
Orquestador: coordina el ciclo diseño → generación → validación → corrección, con un máximo configurable de cinco iteraciones.
Agentes: diseño, generación, validación y corrección; cada agente tiene responsabilidades acotadas.
Integraciones: adaptadores para circuit-synth y kicad-cli, sin acoplar la lógica central a sus APIs.
Workspace: cada proyecto vive en un directorio controlado y se valida para impedir rutas fuera de la raíz.
Validación: reúne diagnósticos estructurados; la aprobación de fabricación requiere comprobaciones reales de ERC/DRC y revisión humana.
Requisitos
Python 3.10 o posterior.
KiCad 7 o posterior para las comprobaciones y exportaciones CLI.
circuit-synth instalado en el entorno elegido.
Un cliente MCP compatible para consumir las herramientas.
Instalación de desarrollo
Crear un entorno virtual.
Instalar el paquete y dependencias: `pip install -e ".[dev]"`.
Copiar `.env.example` a `.env` y configurar rutas si hace falta.
Ejecutar pruebas: `pytest`.
Iniciar el servidor MCP: `pcb-forge-mcp`.
El servidor no debe ejecutarse con privilegios elevados. El código generado por modelos no se ejecuta sin límites: utiliza un entorno aislado, permisos mínimos y límites de tiempo antes de habilitar generación automática en producción.
Herramientas MCP iniciales
`pcb_create_workspace`: crea un workspace con nombre seguro.
`pcb_generate_project`: ejecuta el flujo de diseño con los adaptadores configurados.
`pcb_validate_project`: ejecuta las validaciones disponibles.
`pcb_export_manufacturing`: exporta solo cuando el proyecto pasa las validaciones requeridas.
Plan por fases
Fundación, contratos, pruebas y CI.
Integración verificable con circuit-synth.
Integración con KiCad CLI: ERC, DRC y comprobación de netlist.
Corrección limitada con diagnósticos reproducibles.
Exportación Gerber, taladros, STEP y BOM.
Pruebas de extremo a extremo con diseños de referencia y revisión de fabricación.
Consulta `docs/ARCHITECTURE.md`, `docs/SECURITY.md` y `docs/INTEGRATION.md`.
Aviso de fabricación
Un resultado generado automáticamente no se considera listo para fabricar hasta que los chequeos de ERC/DRC, huellas, reglas del fabricante y archivos de salida hayan sido revisados. No se promete compatibilidad universal con fabricantes.
Available Tools
4 toolspcb_create_workspaceC
Create a project workspace using a safe project name.
Inputs: name (required).
pcb_export_manufacturingB
Export Gerber files after validation; human review is still required.
Inputs: name (required).
pcb_generate_projectC
Generate a circuit project and run configured validation tools.
Inputs: name (required), description (required).
pcb_validate_projectC
Run configured KiCad ERC/DRC checks for an existing workspace.
Inputs: name (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct stage of the PCB workflow (workspace creation, project generation, validation, export). There is mild overlap between pcb_generate_project (which also runs validation tools) and pcb_validate_project, but the descriptions clarify that one creates+validates while the other re-checks an existing workspace.
All tools share the pcb_ prefix and a consistent verb_noun pattern: create_workspace, generate_project, validate_project, export_manufacturing. The convention is uniform and predictable throughout.
Four tools map cleanly onto a single linear pipeline and each earns its place. The set is somewhat thin but well-scoped rather than padded or redundant.
The create→generate→validate→export lifecycle is covered, but there is no way to list or inspect existing workspaces, modify a project, or delete one. These are notable gaps that could force agents into dead ends when revisiting prior work.
Maintenance
Related MCP Connectors
Design, route, check, review and export manufacturable PCBs from plain language; KiCad import.
Design and revise PCBs from plain language, track jobs, and retrieve design artifacts.
Design circuits, simulate and verify embedded firmware, and lay out PCBs with AI agents.
Turn datasheets into source-backed JSON contracts, pinout matrices, and KiCad CAD for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables natural language interaction with KiCad projects, schematics, and PCBs, supporting project management, design rule checking, netlist extraction, and datasheet RAG search.3MIT
- AlicenseBqualityBmaintenanceEnables AI assistants to design PCBs in KiCAD through natural language, with transactional preview-verify-commit workflow, undo/redo, and an engineering knowledge base.141MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with KiCAD for PCB design automation. Users can design PCBs using natural language, including component placement, routing, checks, and export.1MIT
- AlicenseBqualityCmaintenanceEnables creating and editing KiCad projects through natural language, including scaffolding projects, placing schematic symbols, wires and labels, and adding PCB footprints, tracks and nets. It also runs ERC/DRC checks and exports to PDF, SVG, netlist, BOM, STEP, DXF, gerbers and drill files via kicad-cli.141MIT