kicad-mcp-pro

KiCad MCP Pro es un servidor del Model Context Protocol para flujos de trabajo de KiCad EDA. Expone herramientas, recursos y prompts para automatización de esquemáticos, PCB, validación, DFM y exportación para fabricación.

El servidor ahora arranca con el perfil limitado por defecto default: 24 herramientas de revisión de solo lectura en lugar del catálogo completo de experto de 377 herramientas. Usa build con modo escritura para ediciones controladas, release con modo fabricación para entrega supervisada por humanos, o expert/full solo para clientes avanzados de confianza. Consulta docs/agents/progressive-disclosure.md.

La telemetría y el reporte de errores están desactivados por defecto. La configuración opt-in de OpenTelemetry está documentada en docs/configuration.md, y las normas de privacidad en docs/privacy.md.

Alcance y honestidad

KiCad MCP Pro es un asistente profesional de diseño y revisión de primer paso, no una autoridad automatizada de aprobación. ERC/DRC y el pipeline de exportación utilizan los propios motores de KiCad. Las herramientas de integridad de señal, integridad de potencia, EMC y térmicas son estimaciones de primer orden y forma cerrada (típicamente ~5–10% de precisión) — revisión rápida de primer paso, no un sustituto de un solucionador de campo 2D/3D, simulación EM/FEA o aprobación formal. La obtención de componentes en vivo utiliza el catálogo público de JLCPCB por defecto; Nexar, DigiKey y Mouser están disponibles solo cuando se configuran sus credenciales de API. La fracción de la superficie programática de KiCad que maneja el servidor se sigue abiertamente en la matriz de paridad de capacidades.

Related MCP server: KiCad MCP Server

Identidad del proyecto

Inicio rápido

Aplicación de escritorio

Descarga el instalador más reciente desde la página de lanzamientos de GitHub. La aplicación de escritorio Tauri inicia el servidor del panel de control Python automáticamente y abre la interfaz gráfica en http://127.0.0.1:3334/ui. Los lanzamientos de escritorio lanzan la versión exacta del backend correspondiente y verifican su handshake de compatibilidad de escritorio antes de su uso; consulta Instalación.

CLI

uvx kicad-mcp-pro init
uvx kicad-mcp-pro tray
uvx kicad-mcp-pro dashboard --open
uvx kicad-mcp-pro --transport streamable-http --port 3334

Panel web

uvx kicad-mcp-pro dashboard --host 127.0.0.1 --port 3334 --open
# http://127.0.0.1:3334/ui

Documentación

La documentación está organizada desde la configuración hasta la operación:

1. Instalación

2. Configuración del cliente

3. Configuración de ejecución

4. Referencia de herramientas

5. Flujos de trabajo

6. Proceso de lanzamiento

7. Seguridad y privacidad

8. Paridad de capacidades de KiCad — cuánto de la superficie programática de KiCad maneja este servidor

9. Catálogo de códigos de error — códigos de error estables, clases de reintento y recuperación

10. Auditoría de orden de trabajo — estado actual de la orden de trabajo de endurecimiento

La herramienta kicad_capability_parity() informa, por dominio de flujo de trabajo, qué fracción de la superficie programáticamente alcanzable de KiCad puede manejar este servidor (actualmente 76.3%), manteniendo los gaps genuinos distintos de los elementos gui-only-no-api para los que KiCad no expone API sin cabeza.

El sitio de documentación publicado está disponible en https://oaslananka.github.io/kicad-mcp-pro/.

Transportes

KiCad MCP Pro es compatible con stdio y HTTP Streamable. HTTP Streamable se sirve en /mcp por defecto y se puede mover con KICAD_MCP_MOUNT_PATH.

uvx kicad-mcp-pro --transport streamable-http --host 127.0.0.1 --port 3334

Los clientes HTTP Streamable deben enviar:

• Accept: application/json, text/event-stream

• Content-Type: application/json

• MCP-Protocol-Version: 2025-11-25 después de la inicialización

• MCP-Session-Id en solicitudes subsiguientes cuando KICAD_MCP_STATEFUL_HTTP=1

Por defecto, HTTP Streamable es sin estado, por lo que los conectores estilo ChatGPT pueden inicializar y llamar a tools/list sin un proxy de inyección de encabezado de sesión. Establece KICAD_MCP_STATEFUL_HTTP=1 para requerir IDs de sesión después de initialize.

Las rutas de respaldo HTTP+SSE obsoletas están desactivadas por defecto. Establece KICAD_MCP_LEGACY_SSE=1 solo para clientes antiguos que no puedan usar HTTP Streamable.

Instalar

Paquetes publicados:

uvx kicad-mcp-pro --help
npx kicad-mcp-pro --help

Clonado fresco del código fuente en hosts Linux compatibles:

./scripts/bootstrap-dev.sh
source .dev-env.sh
pnpm run dev:doctor -- --ci

El bootstrap del repositorio instala Python, uv/uvx, Node.js, pnpm, Task y Rust tooling con checksums fijos en raíces locales ignoradas del checkout y realiza una instalación congelada de dependencias. No modifica directorios globales de herramientas. Consulta la guía de bootstrap reproducible para los modos --core-only, --check, limpieza, actualización y capacidades de KiCad.

Metadatos del paquete

Las entradas de metadatos canónicas son pyproject.toml para la versión del paquete y la identidad del repositorio, y compatibility.yaml para la política de soporte de KiCad y MCP. server.json es el manifiesto de registro generado. pnpm run metadata:sync renderiza las superficies públicas, y pnpm run metadata:check las verifica en CI y en la validación de lanzamientos.

Uso

Usa kicad-mcp-pro --help para inspeccionar los comandos de CLI y docs/client-configuration.md para configurar un cliente MCP. El catálogo de herramientas generado está disponible en docs/tools-reference.generated.md.

Plugin de agente y habilidades

Este repositorio es el propietario del plugin de agente a nivel de producto y las habilidades específicas de KiCad para KiCad MCP Pro. El repositorio central agent-tools debería catalogar este plugin, pero el manifiesto y las instrucciones de flujo de trabajo viven aquí para mantenerse sincronizados con las herramientas reales del servidor MCP.

Configuración del agente

KiCad MCP Pro se puede iniciar con el paquete Python publicado, el envoltorio npm o los metadatos del contenedor declarados en server.json. Los inicios locales comunes son:

uvx kicad-mcp-pro --transport stdio
uvx kicad-mcp-pro --transport streamable-http --host 127.0.0.1 --port 3334
npx kicad-mcp-pro --help

Para las copias de trabajo del código fuente, ejecute la ruta de validación normal del repositorio antes de publicar cambios en el plugin:

corepack pnpm run metadata:check
python3 -m json.tool .claude-plugin/plugin.json >/dev/null

Flujo de trabajo de validación

Antes de listar este plugin como activo desde agent-tools, verifique que al menos un tiempo de ejecución de agente compatible pueda:

1. Descubrir .claude-plugin/plugin.json.

2. Iniciar o conectarse a kicad-mcp-pro a través de stdio o Streamable HTTP.

3. Llamar a kicad_get_server_info o kicad_get_project_info.

4. Cargar una habilidad de skills/ y seguir el flujo de trabajo sin hacer referencia a herramientas faltantes.

5. Informar ERC, DRC, DFM, artefactos de exportación, suposiciones y requisitos de revisión humana por separado.

KiCad MCP Pro es un asistente de ingeniería, no una autoridad de aprobación de fabricación autónoma. Los resultados de PCB y fabricación generados requieren revisión humana calificada antes de la fabricación o el ensamblaje.

Desarrollo

Los nuevos contribuyentes deberían comenzar con ARCHITECTURE.md, que mapea las cinco capas (transporte → protocolo MCP → orquestación → capa de adaptación de KiCad → dominio puro) y muestra exactamente cómo agregar una nueva herramienta. El modelo de tiempo de ejecución y la pila de puertas de calidad están documentados en docs/development/architecture.md.

El proyecto utiliza un Taskfile.yml para comandos comunes de desarrollo. Después de clonar el repositorio:

task install     # Install all dependencies (pnpm + uv)
task verify      # Run the local quality gate: lint → format → typecheck → test → build
task test        # Run unit tests only
task lint        # Run lint and metadata checks
task format      # Auto-format the codebase
task typecheck   # Run strict static type checking
task build       # Build release artifacts
task ci          # Run the local equivalent of the full CI pipeline
task hooks       # Install local git hooks

Todos los cambios deben pasar task verify antes de abrir una solicitud de extracción.

Contribución

Lea CONTRIBUTING.md antes de abrir una solicitud de extracción. Todos los cambios deben pasar los controles de formato, lint, verificación de tipos, pruebas, flujo de trabajo, seguridad y metadatos del paquete del repositorio.

Citar este software

Si utiliza KiCad MCP Pro en una investigación o publicación técnica, cite la versión archivada a través de su DOI (consulte CITATION.cff para obtener metadatos completos):

@software{aslan_kicad_mcp_pro,
  author  = {Aslan, Osman},
  title   = {KiCad MCP Pro},
  license = {MIT},
  url     = {https://github.com/oaslananka/kicad-mcp-pro},
  doi     = {10.5281/zenodo.21283791}
}

Cada versión de GitHub se archiva en Zenodo bajo este DOI de concepto, que siempre se resuelve a la versión más reciente.

Licencia

KiCad MCP Pro está disponible bajo la Licencia MIT.