IlluGen
Build, validate and render JangaFX IlluGen node graphs from an AI agent, on Windows
- 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.mcpbAdd 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"
]
}
}
}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"
]
}
}
}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.



