FirmForge

English · 中文（README_CN.md）

FirmForge ist eine MCP-basierte Firmware-Verifizierungs-Toolchain für die MCU-Entwicklung mit KI-Codierungsagenten. Sie bietet eine fünfstufige Hardware-Pipeline — Detect, Review, Build, Flash, Verify — und stellt die Stufen den Agenten als MCP-Tools zur Verfügung (ff_detect, ff_context, ff_build, ff_run, ff_flash, ff_monitor).

Die Toolchain kompiliert Firmware mit einem echten Compiler (avr-gcc / ArduinoCore-avr), programmiert das Ziel mit avrdude und verifiziert das Ergebnis über serielles Auslesen. Die Codegenerierung liegt außerhalb des Anwendungsbereichs.

Pipeline

Related MCP server: agentic-hil

Unterstützte Zielsysteme

Benutzerdefinierte Boards werden über --boards-dir unterstützt.

Installation

Anforderungen: Python ≥ 3.10. Hardware ist nur für die Flash- und Verify-Stufen erforderlich.

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

ff setup lädt avr-gcc, avrdude, cppcheck und ArduinoCore-avr herunter und installiert sie in ~/.firmforge/. Ein erneutes Ausführen ist idempotent.

Für MCP-Unterstützung (Agentenintegration):

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

Stabile Wheels sind den GitHub Releases beigefügt.

Ein China-Mirror ist auf Gitee verfügbar: siehe README_CN.md (中文).

Verwendung

# 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

MCP-Server

Registrieren Sie den Server bei Ihrem Agenten (CodeBuddy, Cursor, Claude Desktop, ...):

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

Agenten-Workflow: Fragen Sie ff_context nach Register-/Pin-Referenzen ab, bevor Sie Firmware schreiben, und verwenden Sie dann ff_run zum Kompilieren, Flashen und Verifizieren. Gebündelte Daten (Board-Definitionen, Chip-Wissen, Toolchain-Manifeste) werden aus dem Paket heraus aufgelöst; der Server läuft aus jedem Arbeitsverzeichnis.

Entwicklung

pip install -e .[test,mcp]
pytest

Lizenz

MIT © FirmForge Contributors