FirmForge

English · 中文（README_CN.md）

FirmForgeは、AIコーディングエージェントを用いたMCU開発のためのMCPベースのファームウェア検証ツールチェーンです。Detect、Review、Build、Flash、Verifyの5段階のハードウェアパイプラインを提供し、各ステージを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。ハードウェアが必要なのは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"

安定版の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 Contributors