Skip to content
MCP server

IlluGen

Build, validate and render JangaFX IlluGen node graphs from an AI agent, on Windows

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
Windows, CLI, self-hosted
Runs
Locally
Version
0.1.1
Listing updated
today

Similar MCP servers

About IlluGen

IlluGen is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

IlluGen MCP lets an agent describe a texture, VFX flipbook or procedural mask and then author the .illugen project itself, using your own licensed copy of JangaFX IlluGen. It knows all 157 node types of IlluGen 1.2.1 with real defaults, enum values, ranges and descriptions, and checks pin types before the file reaches IlluGen, suggesting a converter node when types do not match. Curves, gradients, spline points, subgraphs with exposed parameters, modulation and notes are supported, and the 120-plus shipped example presets can be copied and edited.

Editing is done directly on the file with lossless reads and writes. Validation can run offline or load the project in IlluGen and do a trial export, and rendering starts a private hidden IlluGen instance so an open session is untouched and focus is never stolen. Exports include PNG, JPG, TGA, EXR, HDR, OBJ, FBX and flipbook sequences, with failed exports returned with a screenshot.

It needs Windows with an activated IlluGen 1.2.x and Python 3.10 or later; only Windows is tested. The project does not include IlluGen.

Install

Run in a terminal

claude mcp add illugen-mcp -- npx -y https://github.com/dokaNc/illugen-mcp/releases/download/v0.1.1/illugen-mcp-0.1.1.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "illugen-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/dokaNc/illugen-mcp/releases/download/v0.1.1/illugen-mcp-0.1.1.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "illugen-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/dokaNc/illugen-mcp/releases/download/v0.1.1/illugen-mcp-0.1.1.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "illugen-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/dokaNc/illugen-mcp/releases/download/v0.1.1/illugen-mcp-0.1.1.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "illugen-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/dokaNc/illugen-mcp/releases/download/v0.1.1/illugen-mcp-0.1.1.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "illugen-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/dokaNc/illugen-mcp/releases/download/v0.1.1/illugen-mcp-0.1.1.mcpb"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • ILLUGEN_EXEPath to IlluGen.exe, if not installed in C:\Program Files\JangaFX\IlluGen

Tools this server provides (25)

Taken from the project documentation; the running server may differ.

illugen_status
Reports installation, running instances and catalog version
list_node_types
Lists node types
describe_node_type
Describes a node type's parameters, pins and defaults
list_presets
Lists shipped example projects
project_new
Creates an empty project or a copy of a preset
project_summary
Summarizes a project graph
node_get
Reads a node
node_add
Adds a node
node_set
Sets node values
node_remove
Removes a node
link_add
Adds a connection
link_remove
Removes a connection
curve_set
Sets a curve
gradient_set
Sets a gradient
spline_set
Sets spline control points
subgraph_expose_param
Exposes an inner parameter on a subgraph node
annotation_add
Adds a framed group or note
annotation_remove
Removes an annotation
project_set_settings
Sets FPS, loop region and default texture size
node_set_data
Raw access to other node fields
project_thumbnail
Embeds a thumbnail
project_validate
Validates offline or via a real load and trial export
project_render
Exports all export nodes and returns files and a preview
project_screenshot
Screenshots the project open in IlluGen
project_normalize
Loads and saves in IlluGen to fill defaults

What it does

All node types
Builds graphs from 157 documented IlluGen node types.
Type-checked wiring
Validates pin types and suggests converter nodes.
Preset editing
Copies and modifies IlluGen's shipped example projects.
Engine validation
Loads the project in IlluGen and runs a trial export.
Invisible rendering
Renders in a hidden private instance without stealing focus.
Error feedback
Returns failed export details with a screenshot.

Good for

  • Make a tileable stone mask and render it
  • Create a looping smoke flipbook as TGA frames
  • Build a subgraph for edge wear with an exposed seed
  • Explain what an existing .illugen graph does

Pricing

Open source

Free; requires a JangaFX IlluGen licence

IlluGen FAQ

Does it include IlluGen?

No. A valid JangaFX licence and IlluGen 1.2.x install are required.

Does it work on macOS or Linux?

Not yet for rendering; offline editing may work but only Windows is tested.

Will it disturb my open IlluGen?

No. Each render uses its own private instance.

What if IlluGen updates?

Rebuild the node catalog from your install with the build_catalog command.

Is IlluGen free?

Yes. IlluGen is open source, so you can use and self-host it for free.

How do I add IlluGen to Claude Code?

Run this command in your terminal: claude mcp add illugen-mcp -- npx -y https://github.com/dokaNc/illugen-mcp/releases/download/v0.1.1/illugen-mcp-0.1.1.mcpb

What are the best alternatives to IlluGen?

The closest alternatives to IlluGen are HyperFrames by HeyGen, next-ai-draw-io, mcp-for-blender, ffmpeg-skill and cursor-talk-to-figma-mcp.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers