PhotoCraft は「Adobe Photoshop のクリーンルーム再実装を Rust だけで書く」と名乗る OSS だ。star は11,500、コミットは317本、Rust が23クレート・24万7千行ある。ただし最初のコミットは 2026-09-30、公開から8日しか経っていない。

この手の「Photoshop OSS」で最初に知りたいのはどこまでできているのかだが、普通はそこがいちばん分からない。ところがこのリポジトリには scorecard/ があり、自分で採点した結果が TOML で置いてある。集計したら、150項目のうち done が12、missing が99だった。

もうひとつ、AGENTS.md に「every feature drivable by agents」とあり、JSON 制御チャネルと MCP サーバーが入っている。画像エディタの中に AI が入っているのではなく、AI に運転させる側の設計だ。本記事はその2点を測る。

SELF SCORECARD自己採点150項目

Photoshop互換を名乗るOSSの自己採点はdone 12・missing 99

12項目

done(全体の8%)

partial は39

99項目

missing(全体の66%)

bugs は32中29件

20本

エージェント用MCPツール

server.rs の #[tool] を集計

出典: storytold/photocraft scorecard/*.toml(検証コミット 4b53f62・2026-10-05)、crates/automation/src/server.rs

30秒でわかる

・自己採点150項目のうち done は12(8%)、missing は99(66%)。issue 番号と根拠ファイル名つきで公開
・エージェント運転用のMCPツールは20本。コマンドごとにツールを生やさず command_run{id} で呼ぶ
・歯止めは数値で入っている。応答8MiB・PNG 5MiB・プレビュー辺2048px・描画元64Mピクセル
・unsafe 禁止は26中25クレートで機械的に有効。例外は macOS タブレット FFI の3箇所
・ビルドは完了できなかった(rustc 1.95 要求+ディスク)。実行を伴う検証は未検証

MCPサーバーそのものの作り方はMCPサーバーの作り方2026年完全ガイド:TypeScript・Python両対応チュートリアルにまとめてある。本記事はその枝として、既存のGUIアプリにエージェントの運転席を足すとどうなるかを見る。

PhotoCraft とは|Rust 製の Photoshop 互換 OSS

README の冒頭はこうだ。

Image editing; an open-source, clean-room reimplementation of Adobe Photoshop, rebuilt in pure Rust.

Electron でも Tauri でもない。AGENTS.md は「No Tauri, Electron or webview shells」とまで書く。デスクトップは egui/eframe on wgpu のネイティブ、Web 版は同じ Rust を WebAssembly にしたものだ。

項目 実測値
バージョン 0.2.0(ワークスペース)
クレート数 23
Rust ソース 676ファイル / 246,884行
コミット 317本(2026-09-30 〜 2026-10-07)
ライセンス MIT OR Apache-2.0(デュアル)
star / fork / open issue 11,500 / 1,500 / 90
必要な Rust 1.95 以上

8日で24万7千行。レビュー履歴から成熟度は読み取れないが、その代わりになるものを置いている(次の節)。

AI 機能の有無も機械で確かめた。openai・anthropic・onnx・torch などで検索してヒットはなく、diffusion の11件はすべて誤差拡散ディザ、candle の9件はろうそくの炎ブラシだった。モデルを積んだ意味での AI は入っていない。 AI 文脈なのは、AGENTS.md の宣言と、docs/control-protocol.md(267行)が定義する運転用 JSON プロトコルのほうだ。

PhotoCraft の自己採点150項目を集計する

scorecard/ に8つの TOML がある。

git clone --depth 1 https://github.com/storytold/photocraft && ls photocraft/scorecard/

file_compat.toml の冒頭にはこう書いてある。

Statuses must be true on main. Verified against 4b53f62 on 2026-10-05

項目は id・target・status・issue・note を持つ。たとえば FILE-215-2(Smart Filters が PSD 保存後も残るか)は partial で、note には「smart_map.rs: 14個のフィルタは双方向でマップ、それ以外はそのまま保持、PhotoCraft 独自のフィルタは警告を出して filterFX から除外」とある。宣伝文では出てこない粒度だ。

集計結果がこれになる。

自己採点150項目のうち done 12、missing 99、領域別の missing 件数
領域 項目数 done partial missing
bugs 32 0 3 29
tools 30 3 14 13
file_compat 27 1 8 18
ui 23 0 4 19
distribution 11 4 3 4
automation 11 1 3 7
type 9 0 3 6
reliability 7 3 1 3
合計 150 12 39 99

done は8%、missing は66%。 star 11,500 のプロジェクトが自分でそう書いている。「まだ使えない」は正しい結論だが、本題は、「Photoshop の代替」を名乗りながら届いている範囲を数字で出す OSS が少ないことだ。README のバッジも「status: early alpha」で、採点と矛盾していない。

PhotoCraft の MCP サーバー|20ツールの切り方

TOOL DESIGNツールの切り方

コマンドごとに生やさず、command_run の1本で呼ぶ

よくある設計

機能1つにMCPツール1本

  • 機能の数だけ定義が並ぶ
  • ツール定義が文脈を食う

PhotoCraft

20ツール固定

  • command_list で一覧と有効状態を引く
  • command_run {id, params} で実行
出典: crates/automation/src/server.rs。説明文の合計は2,330バイト(スキーマは含まない)

MCP サーバーは crates/automation(9ファイル・2,838行)にあり、公式 Rust SDK(rmcp)で書かれている。#[tool(description = ...)] 属性を抽出すると 20本だった。

分類 ツール
ドキュメント doc_open doc_new doc_save doc_export doc_inspect doc_render_preview doc_select doc_close
コマンド command_list command_run command_batch
ジョブ jobs_list jobs_cancel
UI ui_inspect ui_screenshot ui_pointer ui_menu_invoke ui_set
その他 session_list control_call

description の合計は 2,330バイト(heuristic-jp-v1 で約582トークン)。入力スキーマは含まないので、他のサーバーの「ツール定義の合計」とは直接比べられない下限値だ。

要点は command_list と command_run の組にある。メニュー項目を1つずつツールにせず、command_list で一覧と有効状態を引き、command_run {id, params} で呼ぶ。ソース中のコマンド id 形の文字列は重複なしで827件あったが、メニュー id 等を含みうる文字列抽出なので、正確な数は command_list を実行しないと取れない。本記事では未検証だ。

当サイトが測った tregとは|約2,600エンドポイントを13 MCPツールで配る設計と、Apache表示の裏にある追加条項も、カタログをツールではなくデータとして扱う点で同じ考え方だ。機能ごとにツールを並べる設計の例が Backlog MCPとは|62ツール11,710トークンとENABLE_TOOLSETSでの半減を実測で、あちらは62本で11,710トークン。計測範囲もトークナイザも違うので、桁の比較として読んでほしい。

photocraft-cli mcp だけならウィンドウ無しのヘッドレスで動き、--bridge 127.0.0.1:7878 を付けると起動中のアプリへ転送される。エージェントの見ている状態と人の画面が一致する。

エージェントに運転させるための歯止め

GUARDRAILS運転させる歯止め

エージェントに渡す前に、上限と認証が数値で決まっている

  1. 1.最初の1行が認証

    成功するまで他のメソッドは一切ディスパッチしない

  2. 2.応答8MiB・PNG 5MiB

    プレビュー辺は2048px、描画元は64Mピクセルまで

  3. 3.読み書きルートを起動時に固定

    127.0.0.1 のみ待ち受け、トークンは mode 0600

出典: docs/control-protocol.md、crates/automation/src/security.rs・budgets.rs

起動はこう書かれている。

photocraft --control 7878 --control-token-file /private/path/photocraft-control.token \
  --automation-read-root /work/project --automation-write-root /work/project

待ち受けは 127.0.0.1 のみ。トークンが無ければ 256bit を新規作成し、Unix では mode 0600 で置く。読み書きできるディレクトリは起動時に固定する。仕様はこうだ。

The first request on every TCP connection must authenticate. No other method is dispatched before this succeeds.

security.rs の token_matches はこうなっている。

pub fn token_matches(expected: &str, supplied: &str) -> bool {
    if expected.len() != TOKEN_HEX_LEN || supplied.len() != TOKEN_HEX_LEN {
        return false;
    }
    expected.bytes().zip(supplied.bytes()).fold(0u8, |d, (a, b)| d | (a ^ b)) == 0
}

長さを確認したうえで全バイトを XOR で畳んでから比べる定数時間比較だ。先頭一致で return しないので、タイミング差から1バイトずつ当てられない。

budgets.rs には上限が定数で並ぶ。

定数 値 何を止めるか
MAX_RESPONSE_BYTES 8 MiB 応答の肥大
MAX_PNG_BYTES 5 MiB スクリーンショットの肥大
MAX_PREVIEW_SIDE 2048 px 巨大なプレビュー要求
MAX_RENDER_SOURCE_PIXELS 64 Mピクセル 巨大な元画像の描画

加えて read_bounded_line(1行の長さ上限)と ConnectionLimiter(同時接続数)がある。エージェントが「このPSDを全部プレビューして」と頼んで応答が固まる、という事故を構造的に止めている。エージェントに渡す道具は、何ができるかより何をしないかを先に決めてあるかどうかで出来が分かれる。

Rust だけ・クリーンルームは機械で守られているか

規約が書いてあることと守られていることは別なので、確かめられる範囲を確かめた。

クリーンルーム規約と unsafe 禁止の機械的な強制

unsafe の禁止。ワークスペースの Cargo.toml に unsafe_code = "forbid" がある。ただし [workspace.lints] は各クレートが [lints] workspace = true で取り込まないと効かない。crates/ と apps/ の26個中 25個が opt-in していた。unsafe の実使用は3件で、すべて crates/tablet/src/macos.rs の NSEvent FFI、そして tablet が唯一 opt-in していないクレートだった。例外は1クレート3箇所に封じ込められている。

「unwrap/panic! を使わない」規約は grep で非テストコードに3,000件以上ヒットするが、テストだけ免除する運用でインラインのテストモジュールが大半を占める。単純な件数は指標にならないので数字にしない。

Web 版のサイズ。packaging/web/package.sh は wasm が 24 MiB を超えるとビルドを失敗させる(Cloudflare Pages / Workers の単一ファイル上限 25 MiB への対応)。ピクセル処理のクレートだけ opt-level = 3 に保ち、wasm は 26.3 MiB から 18.8 MiB になったとコメントにある(Issue #198)。

クリーンルーム。docs/contributing.md は「コード・シェーダ・アイコン・ICC プロファイル等を複製せず、観察と公開仕様で合わせる」と明記し、非コード資産は ATTRIBUTION.md(77行)に出所とライセンスつきで列挙される。ただし実態そのものは外部から検証できない。確認できたのは規約の存在と unsafe 禁止が機械で効いていることまでだ。

PhotoCraft は Photoshop の代わりになるか|導入判断

クローンして数えた結果。自己採点150、done 12、MCPツール20、unsafe 3箇所

向いている場面

・画像編集をエージェントに任せる仕組みを作りたい場合。制御チャネルと MCP が最初から入っていて、歯止めも数値で定義されている
・設計を読みたい場合。docs/・scorecard/・AGENTS.md が、GUI アプリにエージェントの運転席を足す実例になる
・PSD の読み書きを Rust でやりたい場合。crates/psd が独立している

向いていない場面

・Photoshop の置き換え。自己採点が missing 99項目と言っている
・安定性を要する用途。bugs.toml は32項目中29件 missing
・手元の Rust が 1.95 未満の環境。ビルドが通らない

現時点で代替するのは Photoshop ではなく、「画像編集の自動化のために自分で書いていたスクリプト」だろう。ImageMagick や Pillow でやっていた処理を、レイヤーとマスクを持つドキュメントモデルの上で、エージェントから叩ける形で行う方向だ。

本記事で測れなかったのは「動かしたらどうか」だ。rustc 1.95 を入れるところまでは進んだが、依存のコンパイル中に target/ が2.1GBを超え、空きディスクとの兼ね合いで中断した。MCP サーバーの実起動、command_list の実数、アプリの実操作は未検証のまま残っている。

参照ソース

・storytold/photocraft(GitHub) — 計測対象。MIT OR Apache-2.0・star 11,500
・docs/control-protocol.md — JSON制御チャネルと MCP ブリッジの仕様
・AGENTS.md — 「every feature drivable by agents」ほか開発規約
・scorecard/ — 集計した自己採点150項目

計測値は data/measurements/runs/2026-10-07-photocraft-agent-control.json に記録した。環境は Ubuntu 24.04 / x86_64 / rustc 1.95.0。ビルドが完了していないため、実行を伴う検証はいずれも未検証。