FirmForge

Español · 中文（README_CN.md）

FirmForge es una cadena de herramientas de verificación de firmware basada en MCP para el desarrollo de MCU con agentes de codificación de IA. Proporciona un pipeline de hardware de cinco etapas — Detect, Review, Build, Flash, Verify — y expone las etapas a los agentes como herramientas MCP (ff_detect, ff_context, ff_build, ff_run, ff_flash, ff_monitor).

La cadena de herramientas compila el firmware con un compilador real (avr-gcc / ArduinoCore-avr), programa el dispositivo objetivo con avrdude y verifica el resultado mediante lectura de retorno serie. La generación de código está fuera del alcance.

Pipeline

Related MCP server: Chiplab

Objetivos compatibles

Las placas personalizadas se admiten mediante --boards-dir.

Instalación

Requisitos: Python ≥ 3.10. El hardware solo es necesario para las etapas Flash y Verify.

pip install git+https://github.com/NotchStone/firmforge.git
ff setup

ff setup descarga e instala avr-gcc, avrdude, cppcheck y ArduinoCore-avr en ~/.firmforge/. Volver a ejecutarlo es idempotente.

Para soporte MCP (integración con agentes):

pip install "firmforge[mcp] @ git+https://github.com/NotchStone/firmforge.git"

Los wheels estables están disponibles en GitHub Releases.

Hay un espejo en China en Gitee: consulte README_CN.md (中文).

Uso

# Detect connected board
ff detect

# Review + compile only (no hardware required)
ff build arduino_mega --app path/to/source

# Full pipeline on hardware
ff run arduino_mega --app path/to/source --expected "Hello World"

# Flash a pre-built hex
ff flash arduino_mega --firmware firmware.hex

Servidor MCP

Registre el servidor con su agente (CodeBuddy, Cursor, Claude Desktop, ...):

{
  "mcpServers": {
    "firmforge": {
      "command": "python",
      "args": ["-m", "firmforge.adapters.mcp_server"],
      "cwd": "/path/to/your/firmware/project"
    }
  }
}

Flujo de trabajo del agente: consulte ff_context para obtener referencias de registros/pines antes de escribir el firmware, luego use ff_run para compilar, flashear y verificar. Los datos incluidos (definiciones de placa, conocimiento del chip, manifiestos de la cadena de herramientas) se resuelven desde el interior del paquete; el servidor se ejecuta desde cualquier directorio de trabajo.

Desarrollo

pip install -e .[test,mcp]
pytest

Licencia

MIT © Contribuyentes de FirmForge