Skip to main content
Glama
PCB Forge MCP
by melo1015

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

  1. Crear un entorno virtual.

  2. Instalar el paquete y dependencias: `pip install -e ".[dev]"`.

  3. Copiar `.env.example` a `.env` y configurar rutas si hace falta.

  4. Ejecutar pruebas: `pytest`.

  5. 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

  1. Fundación, contratos, pruebas y CI.

  2. Integración verificable con circuit-synth.

  3. Integración con KiCad CLI: ERC, DRC y comprobación de netlist.

  4. Corrección limitada con diagnósticos reproducibles.

  5. Exportación Gerber, taladros, STEP y BOM.

  6. 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 tools
pcb_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

    B3.2/5.0

    Scored across 4 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness3/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables natural language interaction with KiCad projects, schematics, and PCBs, supporting project management, design rule checking, netlist extraction, and datasheet RAG search.
      3
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables AI assistants to design PCBs in KiCAD through natural language, with transactional preview-verify-commit workflow, undo/redo, and an engineering knowledge base.
      14
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with KiCAD for PCB design automation. Users can design PCBs using natural language, including component placement, routing, checks, and export.
      1
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables 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.
      14
      1
      MIT