Illustrator Figure MCP

科学フィギュアを編集可能なAdobe Illustratorアートワークとして再構築し、その結果が構造的に正しいことを証明します。

macOSのみ対応（IllustratorはmacOS/Windows対応ですが、これはosascript → do javascriptを使用します）。Adobe IllustratorとClaude Codeが必要です。

なぜこれが存在するのか

Illustratorで描画できるMCPサーバーは数多くありますが、それらはモデルに手を与えるだけで目を与えません。描いたものが正しいかどうかをチェックするものは何もありません。そのため、モデルは描画し、成功と報告しますが、図にはラベルがボックスからはみ出し、矢印が無関係な長方形の途中で終わり、「整列」された3つのパネルが3ptずれている、という状態になります。

価値があるのは描画そのものではありません。検証と修復のループです。これは異なるものを検査する2つのチャネルで動作します:

ジオメトリは証明されます。類似性は判定されます。どちらか一方だけでは不十分です — トレースされた図は、完全に編集不可能でありながらすべてのジオメトリチェックを通過しますし、見栄えの良いレンダリングは構造については何も語りません。

audit_figure が passed: true を返すのは、ハードな幾何学的失敗がないことを意味します。図が正しいことを意味するわけではありません。

Related MCP server: Illustrator MCP Vectorizer

トレースではなく再構築

トレースは見た目を維持し、意味論を破壊します。これは図を再構築する目的そのものです。ショートカットを困難にするための仕組みが3つあります:

• セマンティックタグ付け — すべてのオブジェクトは作成時にUUIDと役割タグを付与され、監査者が構築されたオブジェクトと外部からのオブジェクトを区別できるようにします。

• trace-signature — expandTracing() による Image Trace の出力は、タグなしパスの高密度な塊を生成します。これは trace-signature チェックに引っかかります。

• ラスターゲート。place_image は、分割不能と証明できない配置を拒否します。

ラスターゲート

保持されるすべての画像は5つの宣言をすべて満たす必要があります。これらは記録されるだけでなく検証されます:

強制は作成パス上で行われ、監査者の中ではありません。監査者だけのチェックは、監査を実行しないことで回避されてしまいます。

コネクタ

Illustratorにはコネクタプリミティブがありません。矢印はPathItemであり、それが指すボックスとの関係性を持ちません — ボックスを移動すると矢印は取り残され、静かに間違ったままになります。

add_connector はバインディング（ソース、ターゲット、接続ポイント）をパスに記録します。reflow_connectors はオブジェクトの現在の境界からジオメトリを再計算します。audit_figure は、描画されたパスがバインディングと一致しなくなったときに connector-detached を報告します。

ルーティングは straight、orthogonal、curved のいずれかです — curved は接続エッジに対して垂直に出入りするベジェ曲線で、標準的なフローチャートの見た目になり、矢じりがターゲットに真っ直ぐ向いているように見えます。監査者はアンカー間の弦ではなく実際の曲線をサンプリングするため、インクが実際にある場所を検査します。

オブジェクトを移動またはリサイズする操作の後は、必ず reflow_connectors を実行してください。 矢じりは塗りつぶされた三角形として描画されます。Illustratorはスクリプトから矢じりを公開していないためです。

→ 完全な使用ガイド — インストール、コアルール、ツールリファレンス、2つの実践例、監査レポートの読み方。

インストール

npm install && npm run build

Claude Codeに追加:

claude mcp add illustrator-figure -- node /absolute/path/to/IllustratorFigureMCP/dist/index.js

ツールが初めて実行されるときに自動化の許可を付与してください: システム設定 → プライバシーとセキュリティ → 自動化 → Claude → Adobe Illustrator。

4つのロールスキルをインストール:

cp -R skills/* ~/.claude/skills/

4つのロール

参照画像を添えて「この図をIllustratorで再現して」と依頼すると、recreate-scientific-figure が調整を行います:

各領域は、次の領域が始まる前に完了しなければなりません。その後、図全体が監査されます。

このフォークで追加されたツール

さらに、place_image のラスターゲートと、すべての create_* ツールのセマンティックタグ付け。残りのツールは上流からそのままです（合計71）。

draw_sequence が使い勝手の良いツールです。ボックス、エリアテキストのラベル、2つのバインドされたコネクタを含む領域全体を1回で構築でき、オブジェクトごとに1回呼び出す場合の複数回のラウンドトリップを回避します。

開発

npm test        # 245 tests, runs on any platform

移植されたジオメトリは純粋なES3なので、.jsxモジュールはVMにロードされ、Liang–Barskyとセグメント交差の計算はIllustratorなしでテストされます。Illustratorに依存するものはすべてmacOS上でテストする必要があります。壊れやすい制約についてはCLAUDE.mdを参照してください。

クレジット

• ツールレイヤーは ie3jp/illustrator-mcp-server (MIT) からフォーク — トランスポート、JSXランナー、UUIDアイデンティティ、および63のIllustratorツール。

• 監査タクソノミー、検証ループ、および4ロールプロトコルは icebird1998/scientific-illustrator から移植されました。これはdraw.io、PowerPoint、WPS向けに実装されています。

Adobe、IllustratorはAdobe Inc.の商標です。