FirmForge

英文 · 中文（README_CN.md）

FirmForge 是一个基于 MCP 的固件验证工具链，用于配合 AI 编码代理进行 MCU 开发。它提供五阶段硬件流水线——检测（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: agentic-hil

支持的芯片目标

通过 --boards-dir 支持自定义板卡。

安装

要求：Python ≥ 3.10。仅在烧录和验证阶段需要硬件。

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"

稳定版 wheel 包附在 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 贡献者