kimimgo/viznoir

> VTK is all you need. Cinema-quality science visualization for AI agents.
*One prompt → physics analysis → cinematic renders → LaTeX equations → publication-ready story.*
What it does
An MCP server that gives AI agents full access to VTK's rendering pipeline — no ParaView GUI, no Jupyter notebooks, no display server. Your agent reads simulation data, applies filters, renders cinema-quality images, and exports animations, all headless.
**Works with:** Claude Code · Cursor · Windsurf · Gemini CLI · any MCP client
Quick Start
1. Install
Requires Python ≥3.10. VTK wheel auto-installed (EGL headless rendering supported).
2. Verify
3. Use with an MCP client
Add to your MCP client config (claude_desktop_config.json, ~/.cursor/mcp.json, etc.):
Then ask your AI agent:
> *"Open cavity.foam, render the pressure field with cinematic lighting, then create a physics decomposition story."*
4. Or use as a Python library (advanced)
All tool implementations are importable as async functions. You provide a VTKRunner and await the result:
See docs for the full tool reference.
Capabilities
| Category | Tools |
|----------|-------|
| **Rendering** | render · cinematic_render · batch_render · volume_render |
| **Filters** | slice · contour · clip · streamlines · pv_isosurface |
| **Analysis** | inspect_data · inspect_physics · extract_stats · analyze_data |
| **Probing** | plot_over_line · integrate_surface · probe_timeseries |
| **Animation** | animate · split_animate |
| **Comparison** | compare · compose_assets |
| **Export** | preview_3d · execute_pipeline |
**22 tools** · **12 resources** · **4 prompts** · **50+ file formats** (OpenFOAM, VTK, CGNS, Exodus, STL, glTF, …)
Showcase — 10 Domains, One Pipeline
Every frame below is a single MCP tool call. No GUI, no post-processing, no ParaView.
Annotations are rendered **inside the 3D scene** via VTK-native text actors and leader lines — no Photoshop, no matplotlib overlay.
| | | | | |
|:-:|:-:|:-:|:-:|:-:|
| | | | | |
| **Medical** CT skull volume | **CFD** Combustion streamlines | **Thermal** Heatsink gradient | **Geoscience** Seismic wavefield | **Automotive** DrivAerML · 8.8M cells |
| | | | | |
| **Molecular** H₂O electron density | **Vascular** Cerebral aneurysm MRA | **Planetary** Bennu · 196K triangles | **Structural** Cantilever FEA stress | **Volume** Thermal threshold |
Physics-Aware Animations
Seven presets convert raw simulation data into publication-ready motion — each binds a rendering primitive to a physical phenomenon.
| Preset | Physics | Rendering |
|--------|---------|-----------|
| streamline_growth | Lagrangian advection | Particle path-line extension over time |
| clip_sweep | Pressure gradient cross-section | Moving clip plane |
| layer_reveal | CT density classification | Progressive isosurface stacking |
| iso_sweep | Orbital topology | Isovalue sweep with camera orbit |