# IlluGen

> IlluGen is an open-source MCP server for design and media. Build, validate and render JangaFX IlluGen node graphs from an AI agent, on Windows. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, CLI, self-hosted
- **Repository:** https://github.com/dokanc/illugen-mcp
- **MCP Registry name:** io.github.dokaNc/illugen-mcp
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

```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"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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"
      ]
    }
  }
}
```

## Tools

- `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

## 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.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [next-ai-draw-io](https://ai-powered.com/mcp/next-ai-draw-io-2): next-ai-draw-io is an open-source MCP server for ai models and llm tooling.
- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [cursor-talk-to-figma-mcp](https://ai-powered.com/mcp/cursor-talk-to-figma-mcp): cursor-talk-to-figma-mcp is an open-source MCP server for design and media.
- [Design Feeds](https://ai-powered.com/mcp/design-feeds): Design Feeds is a freemium MCP server for design and media.
- [Meigen AI MCP](https://ai-powered.com/mcp/meigen-ai-mcp): Meigen AI MCP is an open-source MCP server for design and media.
- [Z-Image MCP](https://ai-powered.com/mcp/z-image-mcp): Z-Image MCP is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/illugen
