viznoir MCP server
io.github.kimimgo/viznoir·v0.10.1·19 starsCinema-quality science visualization for AI agents — headless VTK via MCP.
19 stars27 downloads/wk
Reviews
Write oneNobody has reviewed viznoir yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
viznoir tools (23, 8 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
analyze_data[DEPRECATED — use inspect_physics instead] Analyze VTK/simulation data.
animatewrite actionCreate an animation from time series data or camera orbit.
auto_postprocessAutonomous post-processing: inspect → visualize → evaluate → refine.
batch_renderRender multiple fields from the same dataset in one call.
cinematic_renderCinematic-quality rendering with auto-framing, 3-point lighting, SSAO, and PBR.
clipwrite actionCreate a clipped visualization.
compareCompare two simulation results side-by-side or as a difference map.
compose_assetsCompose multiple assets into a deliverable format.
contourwrite actionCreate an iso-surface (contour) visualization.
execute_pipelinewrite actionExecute a custom pipeline definition (advanced).
extract_statsExtract statistical summary (min/max/mean/std) for fields.
inspect_dataInspect a simulation file and return metadata.
inspect_physicsExtract structured physics data for AI storytelling.
integrate_surfaceIntegrate a field over a surface to compute forces, areas, or fluxes.
plot_over_lineSample field values along a line between two points.
preview_3dExport dataset to glTF/glB for interactive 3D viewing in a browser.
probe_timeseriesSample a field value at a fixed point across timesteps.
pv_isosurfacewrite actionRun DualSPHysics IsoSurface to generate VTK surface mesh files.
renderRender a field visualization and return a PNG screenshot.
slicewrite actionCreate a slice (cut plane) visualization.
split_animatewrite actionCreate a split-pane synchronized animation with multiple views.
streamlineswrite actionCreate a streamline visualization for vector fields.
volume_renderVolume render 3D data (CT, MRI, CFD fields) with transfer function presets.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan89 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 6 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How viznoir compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 92/100
- higher than 95% of 48,255 servers
- Tools
- 23
- the typical server has 7
- Tools that change things
- 35%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 19
- more than 91% of 28,688 servers
- Downloads a week
- 27
- more than 14% of 12,191 servers with a package
What its tools let an agent do: 15 read · 7 change · 1 run or deploy
Install viznoir in Claude Code, Cursor or VS Code
claude mcp add viznoir -- uvx viznoir
What the publisher says
From the viznoir repository's README, as published. We do not edit it. Read it on GitHub
viznoir
VTK is all you need. Cinema-quality science visualization for AI agents.
<!-- mcp-name: io.github.kimimgo/viznoir -->
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
pip install viznoir
# With optional extras
pip install "viznoir[mesh]" # meshio + trimesh (50+ formats)
pip install "viznoir[composite]" # Pillow + matplotlib (split_animate)
pip install "viznoir[all]" # everythingRequires Python ≥3.10. VTK wheel auto-installed (EGL headless rendering supported).
2. Verify
mcp-server-viznoir --help # server entry point
python -c "import viznoir; print(viznoir.__version__)"3. Use with an MCP client
Add to your MCP client config (claudedesktopconfig.json, ~/.cursor/mcp.json, etc.):
{
"mcpServers": {
"viznoir": {
"command": "mcp-server-viznoir",
"env": {
"VIZNOIR_DATA_DIR": "/path/to/your/simulation/data",
"VIZNOIR_OUTPUT_DIR": "/path/to/output"
}
}
}
}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:
import asyncio
from viznoir.core.runner import VTKRunner
from viznoir.tools.inspect import inspect_data_impl
from viznoir.tools.render import render_impl
async def main():
runner = VTKRunner()
meta = await inspect_data_impl(file_path="cavity.foam", runner=runner)
print(meta["fields"], meta["timesteps"])
result = await render_impl(
file_path="cavity.foam",
field_name="p",
runner=runner,
colormap="Cool to Warm",
camera="isometric",
width=1920, height=1080,
output_filename="pressure.png",
)
print(result.file_path)
asyncio.run(main())See docs for the full tool reference.
Capabilities
22 tools · 12 resources · 4 prompts · 50+ file formats (OpenFOAM, VTK, CGNS, Exodus, STL, glTF, …)
Showcase — 10 Domains, One Pipeline
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
viznoir: common questions
- Is viznoir MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the viznoir safety report
- How do I install viznoir?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does viznoir need an API key?
- No secret keys are declared. It reads 2 settings from the environment.
- Is viznoir maintained?
- The last commit was 44 days ago (2026-09-21). The latest release is v0.10.1.
- How does viznoir compare with other MCP servers?
- safety score 92/100 (higher than 95% of 48,255 servers); tools 23 (the typical server has 7); tools that change things 35% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.