mirage-gaussifier-mcp
OfficialExports the Gaussian pseudomesh as an OBJ for deformation in Blender and imports it back, enabling edits made in Blender to be brought into the MCP server’s Gaussian image workflow.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
mirage-gaussifier-mcp
An MCP server that turns a photo into an editable image made of Gaussians, and lets an assistant edit it: swirl, magnify, recolour, duplicate, tilt parts out of the picture into 3D, and record the whole editing process as a GIF.
Gaussifier places the initial Gaussians in a fraction of a second.
MiraGe (ICML 2025) fits flat 3D Gaussians on the image plane. Each one is controlled by a triangle, so any edit is a deformation of those triangles and the picture follows.

A quiet afternoon at the lighthouse gets a sunset, blue roofs and a whirlpool; then the lighthouse steps forward, gets a free twin, and grows a big glowing head to stay the taller one. Every step is one MCP tool call; how it was edited lists them, and the plan replays it.
How it works
Gaussify. Gaussifier's equal-mass placement of the image becomes MiraGe's initial point cloud on the image plane, and MiraGe fits it with a mirror camera (about 15 s for 3000 iterations of a 768×512 image on an RTX 5090). Starting from Gaussifier gives a compact model: on Kodak 23 at 3000 iterations it ends with 81k Gaussians (40.9 dB), against 172k (47.2 dB) from MiraGe's default random start.
Edit. Each Gaussian is a triangle (its centre and two scaled axes). Selections pick Gaussians by region or colour; edits move the triangle vertices (or change colour and opacity), and the renderer rebuilds every Gaussian from its triangle. Edits stack, can be undone, and each one takes a strength from 0 to 1, so it can be animated.
Record. While recording, every edit is captured as a short eased animation with a caption. The GIF opens with the Gaussians growing from dots into the photo and can end with a 3D turn of the result.
Related MCP server: Blender Antigravity MCP
Installation
Requirements: Linux, an NVIDIA GPU, CUDA 12.8 or newer with nvcc, CMake, git, curl and
uv.
git clone <this repository> mirage-gaussifier-mcp
cd mirage-gaussifier-mcp
bash scripts/setup.shscripts/setup.sh fetches MiraGe (pinned commit, with two small compatibility fixes for current
compilers and Pillow) and Gaussifier v0.12.0 with its released weights into third_party/,
builds the CUDA extensions and Gaussifier's runtime for the local GPU, and creates the
environment.
Use it from an MCP client
The server speaks MCP over stdio:
{
"mcpServers": {
"mirage-gaussifier": {
"command": "uv",
"args": ["run", "--directory", "/path/to/mirage-gaussifier-mcp", "mirage-gaussifier-mcp"]
}
}
}Put this in your client's MCP configuration (for example .mcp.json in a project, or the
desktop app's settings). Then ask, for example: "Gaussify kodim23.png, make the left parrot
green, swirl the right one, and record it as a GIF."
To script it without a client, scripts/mcp_session.py runs a JSON list of tool calls in one
session and saves every preview:
uv run python scripts/mcp_session.py docs/demo/<name>_plan.json --out previews/Tools
Tool | What it does |
| Image → editable Gaussian image ( |
| Current result, optionally with the image plane turned in 3D ( |
| Name a set of Gaussians: |
| Apply one edit to a selection (below). |
| The edits and their parameters. |
| Edit stack. |
| Record the editing process as a GIF (intro, captions, 3D finale). |
| Loop one edit, or turn the result in 3D, as a GIF. |
| The triangles as an OBJ, to deform in Blender and bring back (MiraGe's workflow). |
Edits: translate, rotate, scale, flip, bulge (magnify or pinch), swirl, wave,
tilt3d (turn a part out of the image plane), lift (toward the viewer), recolor (hue,
saturation, brightness, tint), fade, duplicate. Positions and sizes are fractions of the
image.
Limits: moving or shrinking a region leaves an empty (black) area behind it, since nothing is inpainted; region selections include the background inside them, so intersect a region with a colour selection (or use a polygon) to isolate an object.
Licences
This repository's code is MIT licensed. MiraGe, which scripts/setup.sh downloads and this
server imports, is distributed under its authors' Gaussian-Splatting licence for
non-commercial research and evaluation use only (see third_party/MiraGe/LICENSE.md), and so
is any use of this server with it. Gaussifier is used through its public release.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Edit, light and share Gaussian splats, 3D models and CAD scenes live in the ViewerStudio editor.
Generate images, video, 3D models, audio and Gaussian splats with 100+ AI models.
Turn text or an image into an animation-ready 3D model (GLB): generate, rig, animate, retexture.
Generate, extend and edit AI images and videos, then assemble clips on a timeline and render.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to drive a layered raster image editor with painting, shapes, text, filters, and internet-sourced images and fonts via MCP tool calls, with token-efficient rendering and export.MIT
- FlicenseBqualityCmaintenanceEnables AI assistants in Google Antigravity to drive Blender for 2D-image-to-3D reconstruction, running a multi-stage pipeline to analyze reference images, generate models, compare renders, refine geometry, and produce reports.21-
- AlicenseNot gradedqualityCmaintenanceEnables creating layered 3D reliefs from selected parts of a photo, producing GLB files and a self-contained HTML viewer that tilts with the pointer, with interactive approval of the segmentation before writing files.8 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to model, sculpt, rig, animate and bake particle effects by editing a semantic scene document, with built-in software rendering, measurable critics that flag floating or broken geometry, and game-ready glTF export. It exposes templates, atomic edit batches, motion and effect previews, undo history, and no GPU, browser, or Blender required.10 npmApache 2.0