IlluGen

Install

Works with Claude Desktop. Read the repository before you give any tool access to your data.

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools

9 read · 11 write · 3 delete · 2 not yet classified

Secrets

None asked for

Install scripts

None found

Runs as

Downloaded binary

Tools (25)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• annotation_addAdd annotation

  Adds a comment to the node graph: a framed group around nodes, or a free text note. Annotations only document the graph; they do not change the rendered result. Writes the project file in place. Returns {"group": index} or {"note": index}, the index to pass to annotation_remove.

• annotation_removeRemove annotation

  Deletes one group or note annotation from the node graph. The indexes of later annotations of the same kind shift down by one: re-read project_summary before removing another. Fails if the index does not exist. Writes the project file in place. Returns {"ok": true}.

• curve_setSet curve

  Replaces all the keys of a node's curve (remap curves, custom oscillator waveforms...). The previous keys are discarded. Writes the project file in place. Returns: curve (name written) and keys (number of keys).

• describe_node_typeDescribe node type

  Describes one node type: its parameters, curves and typed input/output pins. Call it before node_add or node_set to get valid parameter names, value kinds, defaults, enum values and UI ranges, and before link_add to get pin names and the data kind each pin carries. Offline and read-only. Pin kinds: Grayscale, Color, UV, Normal, Islands, GeometryBuffer...; 'Inherit' takes the kind of whatever is connected; 'Signal' is a modulator (Oscillator, Cycle, Constant...). Returns: type, category, params {name: {kind, default, values for enums, min/max, label, modulatable}}, curves, pins {inputs, output…

• gradient_setSet gradient

  Replaces a node's color gradient (Color Ramp, Color Interpolate, Geometry Combine Color...). The previous stops are discarded. Fails if the node has no gradient. Writes the project file in place. Returns: stops (number written) and color_space.

• illugen_statusIlluGen status

  Reports whether IlluGen is installed and which node catalog this server uses. Call it first when an engine tool (project_render, project_validate with engine=true, project_screenshot, project_normalize) fails, or to find the folder of the shipped presets. Takes no arguments, does not start IlluGen and changes nothing. Returns: exe (path used, set with the ILLUGEN_EXE variable), installed (bool), running_instances (IlluGen processes currently open, GUI ones included), catalog_illugen_version and node_types (IlluGen version and node count of the bundled catalog), presets_dir.

• link_addLink pins

  Connects an output pin of one node to an input pin of another. Any existing connection into that input is replaced. Pin data kinds are checked (Grayscale, Color, UV...) and a mismatch fails with an explanation. Parameter pins (e.g. 'Scale', 'Seed') let a Signal node (Oscillator, Cycle, Constant...) drive a parameter; optional inputs (e.g. Levels 'In Low mod') are exposed automatically. Subgraph pins are the labels of the subgraph's inner Node_Input/Node_Output nodes. Writes the project file in place. Returns: link {from_node, from_pin, to_node, to_pin} and warnings if any.

• link_removeUnlink pin

  Disconnects an input pin: removes the link(s) arriving at `to_pin` of `to_node`. Writes the project file in place. If the pin drove a parameter, the parameter gets a fixed value again (its default if it had none). Removing nothing is not an error. node_get lists a node's incoming links. Returns: removed, the number of links deleted (0 if the pin was not connected).

• list_node_typesList node types

  Lists the IlluGen node types this server can create, grouped by category. Use it to find a type name for node_add, then describe_node_type for that type's parameters and pins. Offline (IlluGen not needed) and read-only. Returns {category: [type names]}, e.g. {"Grayscale": ["Node_Grayscale_Noise", ...]}; an empty object means nothing matched the filters.

• list_presetsList presets

  Lists the example projects shipped with IlluGen, usable as starting points. Pass a returned name to project_new(from_preset=...) to get an editable copy; the presets themselves are never modified. Read-only; reads the presets folder of the installed IlluGen. Returns [{name, path}], sorted by name. The list is empty when nothing matches or when IlluGen is not found (check illugen_status).

• node_addAdd node

  Adds a node to the graph with IlluGen's default values, optionally setting some parameters. Writes the project file in place. Parameter values are checked: an unknown name or invalid enum value fails with suggestions and nothing is saved; a value outside the UI range is kept and reported in warnings. Connect the new node with link_add afterwards. Returns: id (string id of the new node), type, and warnings if any.

• node_getGet node

  Returns every detail of one node: parameter values, curves, gradients, spline points, pins and links. Use it before node_set, curve_set, gradient_set, spline_set or node_set_data to see current values and exact names; use project_summary for the whole graph. Offline and read-only. Returns: id, type, label, pos, disabled, params {name: value} ('<driven by link>' when a Signal drives it), curves {name: [[position, value], ...]}, gradients, spline_points, subgraph pins for subgraphs, parameter_pins, outgoing and incoming links, known_inputs and known_outputs.

• node_removeRemove node

  Deletes a node from the graph, with its outgoing links and every link from other nodes into it. Writes the project file in place and cannot be undone: copy the file first if you may need the node back. To bypass a node without losing it, use node_set(disabled=true) instead. Returns: removed_links, the number of links from other nodes that pointed to the deleted node.

• node_setSet node

  Changes an existing node's parameter values, label, position or disabled flag. Only what you pass changes. Writes the project file in place; values are checked like in node_add. For curves, gradients and spline points use curve_set, gradient_set and spline_set. Returns: changed {name: new value} and warnings (value outside the UI range, or parameter currently driven by a link, in which case the value only applies once unlinked).

• node_set_dataSet raw node data

  Low-level escape hatch: overwrites one raw field of a node's internal data block. Use it only for fields that node_set, curve_set, gradient_set and spline_set do not cover. The value is written without type checking, so run project_validate(engine=true) afterwards. Writes the project file in place. Returns {"ok": true}.

Signals

Stars

3

Forks

0

Open issues

0

Last commit

Oct 15, 2026 (15 days ago)

Last release

Oct 15, 2026 (15 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name

io.github.dokaNc/illugen-mcp

Version

0.1.1

Auth

No auth

Packages

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

License

MIT

Repository

github.com/dokaNc/illugen-mcp

Website

github.com/dokaNc/illugen-mcp

First seen

Oct 24, 2026

Last checked

Oct 25, 2026

Source

Official MCP Registrygithub-graphql