IlluGen

IlluGen MCP

AI エージェントに JangaFX IlluGen のノードグラフを構築、編集、レンダリングさせましょう。

テクスチャ、VFX フリップブック、プロシージャルマスクを普通の言葉で説明すると、エージェントが .illugen プロジェクトを作成し、ノードを接続してチェックしたうえで、お使いの IlluGen でレンダリングします。クリック操作もウィンドウも不要です。

クイックスタート · できること · ツール · 仕組み · FAQ

_{実際のツール呼び出しと所要時間、実際の IlluGen レンダリングです。examples/demo_scenes.py で再現できます。}

クイックスタート

1. 必要条件

• Windows と、インストールおよびライセンス認証済みの IlluGen 1.2.x（有効な JangaFX ライセンスが必要です。このプロジェクトは IlluGen を含まず、代替するものでもありません）。
• Python 3.10+。uv の使用を推奨します（手動インストールは不要です）。

2. エージェントに追加する

Claude Desktop：ワンクリック

最新リリースから illugen-mcp-<version>.mcpb をダウンロードして開くか、Claude Desktop › Settings › Extensions にドラッグします。PATH に uv が必要です。IlluGen を別の場所にインストールした場合は、拡張機能の設定でパスを指定してください。

Claude Code

claude mcp add illugen -s user -- uvx --from git+https://github.com/dokaNc/illugen-mcp illugen-mcp

Claude Desktop、Cursor、Windsurf、VS Code、Gemini CLI…（任意の MCP クライアント）：クライアントの MCP 設定（claude_desktop_config.json、.cursor/mcp.json など）に以下を追加します。

{
  "mcpServers": {
    "illugen": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/dokaNc/illugen-mcp", "illugen-mcp"]
    }
  }
}

pip install git+https://github.com/dokaNc/illugen-mcp
claude mcp add illugen -s user -- illugen-mcp

claude mcp add illugen -s user -e ILLUGEN_EXE="D:\Apps\IlluGen\IlluGen.exe" -- uvx --from git+https://github.com/dokaNc/illugen-mcp illugen-mcp

"env": { "ILLUGEN_EXE": "D:\\Apps\\IlluGen\\IlluGen.exe" }

3. 尋ねる

エージェントを再起動して、次のように試してください。

Check that IlluGen is reachable with illugen_status, then build me a tileable stone mask
and render it to C:\Users\me\Desktop\stone.

できること

• グラフをゼロから構築：IlluGen 1.2.1 の 157 種類すべてのノードタイプ（Grayscale、Color、UV、Geometry、Islands、Utils、シグナル、インポート／エクスポートなど）と、実際のデフォルト値、使用可能なすべての列挙値、範囲、単位、説明に対応しています。
• 安全に接続：ピンの型（Grayscale、Color、UV、Normal、Islands、GeometryBuffer など）は、IlluGen がファイルを読み込む前にチェックされます。型が一致しない場合は、エラーで変換ノードが提案されます。
• 通常のパラメーターを超えて対応：カーブ、カラーグラデーション、スプライン／ラティスの制御点、公開パラメーターを持つサブグラフ、シグナル変調（Oscillator → Scale など）、フレーム付きグループ、メモに対応しています。
• 付属のサンプルから開始：IlluGen に付属する 120 種類以上のサンプルプリセットをコピーして、編集できます。
• 実際に検証：project_validate(engine=true) は IlluGen でプロジェクトを読み込み、試験エクスポートを実行します。削除されたノードやリンク、ログエラー、警告ダイアログのスクリーンショットを報告します。
• レンダリング：project_render はすべてのエクスポートノードで File › Export を実行します（PNG、JPG、TGA、EXR、HDR、RAW、R16、R8、OBJ、FBX、フリップブックシーケンスなど）。生成されたファイルとインラインプレビューを返します。
• 作業の邪魔をしない：レンダリングには、専用の非表示 IlluGen インスタンスを使用します。起動中の IlluGen はそのまま動作し、マウスやキーボードのフォーカスを奪うこともありません。

ツール

一般的な流れ：project_new → node_add … → link_add … → project_validate(engine=true) → project_render。

ショーケース

溶岩（ボロノイノイズ → レベル → カラーランプ → グロー）、コースティクス（ポリゴンフラクタル → コースティクス → ランプ）、エネルギー ウェブ（ボロノイエッジ → ランプ → グロー）：それぞれ 4〜5 個のノードで構成され、エージェントが約 15 秒で作成・レンダリングしました。 正確なグラフは examples/demo_scenes.py にあります。

プロンプトの例

Open the "brick_wall" preset, make it 2048x2048, make the bricks darker and render it.

Create a 64-frame looping smoke flipbook (8x8 atlas), export as TGA to D:\fx\smoke.

Build a subgraph "edge wear" (noise + levels + blur) with its seed exposed, use it twice with
different seeds and blend the results.

Explain what every node in C:\projects\lava.illugen does and suggest how to make it less noisy.

仕組み

• 編集はファイルに直接行います。 .illugen プロジェクトは損失なく読み書きされるため（変更せずに保存したファイルはバイト単位で同一です）、オフラインでの編集はすぐに安全に行えます。ノード定義は IlluGen 1.2.1 に対応する同梱のテーブルを使用します。
• レンダリングには IlluGen 自体を使用します。 サーバーは画面やタスクバーに表示されないように、自身のフォルダー内で IlluGen の専用コピーを起動し、プロジェクトを読み込んで IlluGen 独自のエクスポートショートカットを実行します。IlluGen のログで進行状況を確認し、完了後に終了します。お使いの設定や開いている IlluGen のウィンドウには影響しません。
• エラーはエージェントに返されます。 エクスポートの失敗や読み込み時の警告を検出し、スクリーンショットとともに返すため、エージェントはグラフを自力で修正できます。

サーバーが書き込むファイル：指定した場所のプロジェクトとレンダリング結果、および %LOCALAPPDATA%\illugen-mcp 内の一時フォルダー（ILLUGEN_MCP_HOME で変更できます）。

IlluGen の更新

同梱のノードテーブルは IlluGen 1.2.1 を対象としています。IlluGen の更新後は、インストール先からカタログを再構築してください（数分かかります。IlluGen は画面に表示されずに実行されます）。

uvx --from git+https://github.com/dokaNc/illugen-mcp python -m illugen_mcp.build_catalog

新しいカタログは %LOCALAPPDATA%\illugen-mcp\data に保存され、同梱のカタログより優先されます。

FAQ

macOS または Linux で動作しますか？ まだ対応していません。レンダリングでは Windows 版の IlluGen を起動します。オフライン編集（project_*、node_*、link_*）は純粋な Python で実装されているため、ほかの環境でも動作するはずですが、テスト済みなのは Windows のみです。

起動中の IlluGen に影響しますか？ いいえ。レンダリングはそれぞれ独自の設定ファイルとリカバリファイルを持つ、個別の隔離されたインスタンスで実行されます。

IlluGen did not finish starting IlluGen を手動で一度起動し（ライセンスを有効化し、ウェルカム画面を閉じてください）、illugen_status でパスを確認してから、%LOCALAPPDATA%\JangaFX\illugen\logs にある最新のログを確認してください。問題が解消しない場合は、そのログを添えてIssue を作成してください。

レンダリングで「Nodes failed to export」と表示されます。 通常はグラフの問題です（ピンの型の不一致、入力の未接続など）。エラーとともに返されるスクリーンショットでは、ノードが警告状態で表示されます。describe_node_type で想定されるピンの型を確認できます。

IlluGen のキーボードショートカットを変更しました。 対応しています。サーバーは IlluGen の config.ini からショートカットを読み取ります。

開発

git clone https://github.com/dokaNc/illugen-mcp
cd illugen-mcp
pip install -e ".[dev]"
pytest                      # tests needing IlluGen are skipped automatically if it isn't installed
ruff check .

コントリビューションを歓迎します。CONTRIBUTING.mdをご覧ください。

免責事項

IlluGen MCP は独立したコミュニティプロジェクトです。JangaFX とは提携関係になく、同社から承認やサポートを受けていません。IlluGen および JangaFX は、それぞれの所有者の商標です。IlluGen のライセンス済みコピーはご自身で用意する必要があります。このプロジェクトに IlluGen は含まれておらず、IlluGen を変更することもありません。

ライセンス

MIT