Skip to main content

viznoir

English | 한국어 | 中文 | 日本語 | Deutsch | Français | Español | Português

VTK is all you need. Cinema-quality science visualization for AI agents.

CI PyPI Python License: MIT Mentioned in Awesome VTK


Science Storytelling

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

pip install mcp-server-viznoir

Add to your MCP client config:

{
  "mcpServers": {
    "viznoir": {
      "command": "mcp-server-viznoir"
    }
  }
}

Then ask your AI agent:

"Open cavity.foam, render the pressure field with cinematic lighting, then create a physics decomposition story."

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, …)

Architecture

  prompt                    "Render pressure from cavity.foam"
    │
  MCP Server                22 tools · 12 resources · 4 prompts
    │
  VTK Engine                readers → filters → renderer → camera
    │                       EGL/OSMesa headless · cinematic lighting
  Physics Layer             topology analysis · context parsing
    │                       vortex detection · stagnation points
  Animation                 7 physics presets · easing · timeline
    │                       transitions · compositor · video export
  Output                    PNG · WebP · MP4 · GLTF · LaTeX

Numbers

22 MCP tools 24 VTK filters
10 domains 19 native file formats
6/6 VTK data types 50+ formats via meshio

Documentation

Homepage: kimimgo.github.io/viznoir

Developer docs: kimimgo.github.io/viznoir/docs — full tool reference, domain gallery, architecture guide

License

MIT

Metadata

Release files for viznoir 0.8.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for viznoir 0.8.1
File Size Uploaded
viznoir-0.8.1.tar.gz 3.8 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for viznoir 0.8.1
File Interpreter ABI Platform
viznoir-0.8.1-py3-none-any.whl Python 3 none any Details

Total release size: 4.0 MB

Release files / viznoir-0.8.1.tar.gz

Download URL viznoir-0.8.1.tar.gz
Size 3.8 MB
Tags Source
SHA-256 checksum
How to use checksums
887b395021e90448527966bc08b7128cf0aa2fcb2676af3bb34e7b6a65b20a87
BLAKE2b-256 checksum
How to use checksums
996e9e1bfe709d1fd17cb2a34737d07f1ee1287a6623d6c9764e6b8575e9711d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release files / viznoir-0.8.1-py3-none-any.whl

Download URL viznoir-0.8.1-py3-none-any.whl
Size 190.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
523af8259642509edd84edd1c725299b4a4f22d021bfda387db0b1a7f8b9dab7
BLAKE2b-256 checksum
How to use checksums
b4d8c69ac941ba019066f871c8802d38afce8709e7018adaab831d9e2a6a39b7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release history Release notifications | RSS feed

0.9.1

2 release files

This release

0.8.1 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page