FirmForge

Английский · 中文（README_CN.md）

FirmForge — это инструментальная цепочка проверки прошивки на основе MCP для разработки MCU с AI-агентами кодирования. Она предоставляет пятиэтапный аппаратный конвейер — Detect, Review, Build, Flash, Verify — и предоставляет этапы агентам в виде MCP-инструментов (ff_detect, ff_context, ff_build, ff_run, ff_flash, ff_monitor).

Инструментальная цепочка компилирует прошивку с помощью реального компилятора (avr-gcc / ArduinoCore-avr), программирует целевое устройство с помощью avrdude и проверяет результат через последовательное чтение. Генерация кода не входит в область применения.

Конвейер

Related MCP server: Chiplab

Поддерживаемые целевые устройства

Пользовательские платы поддерживаются через --boards-dir.

Установка

Требования: Python ≥ 3.10. Оборудование требуется только для этапов Flash и Verify.

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

ff setup загружает и устанавливает avr-gcc, avrdude, cppcheck и ArduinoCore-avr в ~/.firmforge/. Повторный запуск идемпотентен.

Для поддержки MCP (интеграция с агентами):

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

Стабильные сборки прикреплены к GitHub Releases.

Зеркало для Китая доступно на Gitee: см. README_CN.md (中文).

Использование

# 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-сервер

Зарегистрируйте сервер в вашем агенте (CodeBuddy, Cursor, Claude Desktop, ...):

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

Рабочий процесс агента: запросите ff_context для ссылок на регистры/пины перед написанием прошивки, затем ff_run для компиляции, прошивки и проверки. Встроенные данные (определения плат, знания о чипах, манифесты инструментов) разрешаются изнутри пакета; сервер работает из любой рабочей директории.

Разработка

pip install -e .[test,mcp]
pytest

Лицензия

MIT © Участники FirmForge