Compositor

compositor-mcp

Claude やその他の AI エージェントが、Mac 用のオープンソースの Photoshop 代替ソフトである Compositor のプロジェクトを読み込み、編集できるMCPサーバーです。

ドキュメント化された .comp パッケージ形式（manifest.json とレイヤーごとの PNG で構成）で動作するため、Compositor 自体を変更する必要はありません。エージェントでプロジェクトを編集してから、Compositor で開けます。 または逆に、Compositor で保存して、エージェントに内容の確認、レタッチ、レンダリングを任せることもできます。

エージェントでできること

ツール	目的
inspect_project	キャンバスサイズ、解像度、およびフォルダー階層、透明度、不透明度、ブレンドモード、変形、マスク、クリッピング情報を含むすべてのレイヤーを確認します
list_layers	レイヤーパネルのように、上から下へのレイヤー一覧をコンパクトに表示します
render_preview	統合した PNG プレビューを画像として返し、モデルが合成内容を 確認 できます
export_flattened	フル解像度の PNG または JPEG に書き出します
export_layer	レイヤーの元ピクセルまたはマスクをファイルにコピーします
create_project	ドキュメントを新規作成します。オプションで単色の背景レイヤーを追加できます
add_image_layer	PNG、JPEG、HEIC、TIFF、WebP などを、フィット／塗りつぶし／引き伸ばしの配置、不透明度、ブレンドモード、フォルダーを指定してレイヤーとして読み込みます
add_folder	レイヤーフォルダーを作成します
set_layer	レイヤー名、表示／非表示、不透明度、ブレンドモード、位置、サイズ、回転、反転、サンプリング、マスクの有効／無効を設定します
move_layer	レイヤーの順序を変更するか、別のフォルダーに移動します
remove_layer	レイヤーまたはフォルダー全体を削除します
replace_layer_image	レイヤーのピクセルを差し替えます（別のツールや生成画像との間で受け渡しできます）
set_layer_mask	グレースケールマスクを設定、反転、または解除します
resize_canvas	再サンプリングせずに、アンカーを指定してドキュメントサイズを変更します
open_in_compositor	Compositor アプリでプロジェクトを開きます

サーバーは、ファイル形式を説明する compositor://format リソースも公開します。

関連プロジェクト

marcushorndt/compositor-mcp は別の方法を採用しており、Compositor 独自のドキュメントモデルとレンダラーをヘッドレスで（Swift で）操作するため、プレビューはアプリと完全に一致します。このパッケージは、ドキュメント化されたファイル形式を扱うプレーンな Node サーバーで、アプリのビルドは不要で、Node が動作する場所ならどこでも実行できます。環境に合う方を選んでください。どちらも同じ .comp ファイルを開けます。

インストール

Node.js 20 以降が必要です。結果を確認する場合にのみ、Compositor が必要です。

Claude Code

claude mcp add compositor -- npx -y compositor-mcp

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "compositor": {
      "command": "npx",
      "args": ["-y", "compositor-mcp"]
    }
  }
}

ソースからインストール

git clone https://github.com/Josusanz/compositor-mcp
cd compositor-mcp
npm install
npm run build
claude mcp add compositor -- node /path/to/compositor-mcp/dist/src/index.js

セッション例

白い背景の 1920×1080 のプロジェクトを ~/Desktop/poster.comp に作成し、photo.jpg を全体にフィットするよう拡大縮小して追加してください。logo.png は右下隅に、不透明度 80 %、乗算で配置し、プレビューを表示してから Compositor で開いてください。

エージェントは create_project、add_image_layer を 2 回、set_layer、render_preview、open_in_compositor を呼び出します。Compositor でドキュメントを開くと、レイヤーはそのまま編集を続けられる状態になっています。

Compositor の形式との対応

• レイヤーのピクセルは 8-bit sRGB PNG として未加工のまま保存されます。配置、拡大縮小、回転、反転はレイヤーの変形情報に保存されるため、編集は非破壊のままです。
• マスクは、Compositor の要件に従い、アルファチャンネルのない 8-bit グレースケール PNG として書き込まれます。
• マニフェストは、書き込み前に ProjectStore.swift と同じルールで検証され、キーをソートして書き込んだ後、アトミックに置き換えられます。
• このツールが認識しないフィールド（調整、エフェクト、テキスト、図形、ガイド、新しい機能など）は、保存して再読み込みする際も保持されます。
• プロジェクトは形式バージョン 9（Compositor 1.2.6 が書き込むバージョン）で保存されます。より新しいバージョンが宣言されているプロジェクトは、保存して再読み込みする際も、そのバージョン番号と未知のフィールドが保持されます。古い Compositor のビルドでは新しいバージョンを開けません。ファイルが開けない場合はアプリを更新してください。

制限事項

• プレビューのレンダラーは、順序、フォルダー、表示状態、不透明度、変形、ラスターマスク、および sharp が対応しているブレンドモードを反映します。クリッピングマスク、調整レイヤー、レイヤー効果はまだレンダリングされず、ツールはスキップした項目を報告します。Compositor 自体のエクスポートが基準となります。
• Compositor はファイルの変更を監視しません。エージェントがすでに開いているプロジェクトを編集した後は、ドキュメントを閉じて再度開くか（または open_in_compositor を呼び出してください）。
• 実行中のアプリとのライブ接続はありません。選択、取り消し履歴、ビューポートは Compositor のセッション内に限られ、ここからは利用できません。

開発

npm install
npm test        # builds and runs the node:test suite
npm run dev     # runs the server from TypeScript with tsx

ライセンス

MIT。Compositor の著作権は Robbie Tilton が所有しており、ライセンスも MIT です。