Vmd Hydrate MCP server
io.github.wjgoarxiv/vmd-hydrate-mcp·v0.2.0Drive VMD for GROMACS/LAMMPS analysis + clathrate-hydrate cage science (needs a local VMD)
0 stars24 downloads/wk
Reviews
Write oneNobody has reviewed Vmd Hydrate yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Vmd Hydrate tools (17, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
add_representationAdd a representation WITHOUT clearing existing ones — layer several reps (e.g. water as Points + solute as VDW). `color` is a coloring METHOD (Name, ResName, ResType, Chain, Beta, ...); `style` is VDW/Lines/Points/ NewCartoon/Licorice/etc.
clear_representationswrite actionRemove all representations from a molecule (start a fresh view).
hbond_networkBuild the water-water hydrogen-bond network for a frame and report bond count and average coordination (the substrate for cage identification). rcut is the O-O cutoff (nm), theta the H-O...O angle cutoff (degrees).
hydrate_order_paramswrite actionCompute clathrate-hydrate water order parameters F3 (tetrahedrality) and F4 (<cos 3phi>) for a frame. F4 ~ 0.7-0.95 indicates hydrate/crystalline order, ~0 liquid, negative ice-Ih. Units are nm; for .gro the native nm parser is used. This is the differentiating capability no other MCP offers.
identify_cagesIdentify clathrate-hydrate cages (5^12, 5^12 6^2, 5^12 6^4, ...) from the water H-bond network and classify the crystal structure (sI/sII/sH). Returns per-type cage counts, the structure label, and a confidence. method="TRACE" (all rings) or "HTR" (primitive rings). GROMACS .gro input.
list_moleculesList molecules currently loaded in the VMD session (molid, path, atoms, frames).
load_structureLoad a structure/trajectory into the persistent VMD session for visualization. Supports PDB, GROMACS (.gro/.xtc/.trr), LAMMPS (.data/dump), DCD. Coordinate-only formats (.xtc/.trr/.dcd) require a `topology`. Returns the molid used to reference this molecule in later calls.
measure_geometryMeasure a distance (2 atom indices), angle (3), or dihedral (4) at a frame. Distances are in Angstrom, angles in degrees.
radius_of_gyrationRadius of gyration (Angstrom) of an atom selection at a frame.
renderRender the current view of a loaded molecule headlessly (CPU Tachyon) and return a PNG image. Resolution is capped for safety.
render_cagesRender clathrate cages photorealistically (ambient occlusion + shadows, orthographic by default). Each cage type is drawn in ONE unified color for both its water-oxygen vertices and its O-O framework, using a curated palette (512=cyan, 51262=violet, 51264=red, 435663=lime, 51268=blue).
reset_viewReset/fit the camera to the loaded molecule.
resolve_selectionReport how many atoms an MDAnalysis selection matches — use this to catch the common 0-atom trap on bare .gro files before running measurements.
rotate_viewRotate the camera by `degrees` about an axis ('x'/'y'/'z'). In GUI/attended mode (VMD_HYDRATE_MCP_DISPLAY=gui) the visible window updates live.
set_representationSet the visual representation of a loaded molecule (e.g. style=NewCartoon, Licorice, VDW, Lines; color=Name, ResType, Beta; selection is a VMD atom-selection string like "water" or "name CA").
vmd_statusReport whether VMD is available, its version, and the molecules currently loaded in the persistent session.
zoom_viewZoom the view by a multiplicative factor (>1 zoom in, <1 zoom out).
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- Code scan22 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 85 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Vmd Hydrate compares
Against every graded Productivity MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 88/100
- higher than 75% of 1,299 Productivity servers
- Tools
- 17
- the typical Productivity server has 7
- Tools that change things
- 12%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 24
- more than 9% of 427 Productivity servers with a package
What its tools let an agent do: 13 read · 1 create · 3 change
Install Vmd Hydrate in Claude Code, Cursor or VS Code
claude mcp add vmd-hydrate-mcp -- uvx vmd-hydrate-mcp
What the publisher says
From the Vmd Hydrate repository's README, as published. We do not edit it. Read it on GitHub
<!-- mcp-name: io.github.wjgoarxiv/vmd-hydrate-mcp -->
vmd-hydrate-mcp Drive VMD from any LLM — render GROMACS/LAMMPS trajectories and analyze clathrate-hydrate cages through the Model Context Protocol. Quick Start · Features · MCP Tools · Usage · 한국어
[!NOTE]
An MCP server that lets Claude (or any MCP client) control VMD directly — load GROMACS/LAMMPS trajectories, identify clathrate-hydrate cages (sI/sII/sH), script headless renders, and compute order parameters (F3/F4) and H-bond networks — turning molecular-dynamics analysis into a conversation. Unlike the existing VMD MCP, it keeps a stateful VMD session, is secure by default, and owns the one thing no other MCP does: hydrate cage science.
See it in action
Every frame is a real headless VMD (Tachyon) render, driven entirely through the MCP server. The sII cages — 128 × 5¹² + 60 × 5¹²6⁴ — are identified by this repo, not mocked. · ▶ full-quality MP4
Features
- Clathrate Cage Identification -- find and classify hydrate cages (5¹², 5¹²6², 5¹²6⁴, …) from the H-bond network and label the crystal structure (sI/sII/sH). Validated on the sII benchmark (128 small cages, exact).
- Photorealistic, Style-by-Prompt Cage Rendering -- cages render with ambient occlusion + shadows, orthographic by default, each cage type in ONE unified color (a curated palette: 5¹²=cyan, 5¹²6⁴=red, …). Just ask: "show only the sII large cages in magenta with emphasized width" and the MCP filters, recolors, and thickens them.
- Stateful VMD Session -- a persistent VMD process (Tcl socket server) keeps your molecules, selections, and camera alive across tool calls -- no reloading on every command.
- Hydrate Order Parameters -- F3 (tetrahedrality) and F4 (⟨cos 3φ⟩) computed in pure NumPy, validated to the reference to 6 decimals (F4 = 0.926698 on the sII benchmark).
- H-bond Networks -- water–water hydrogen-bond graph with coordination stats, the substrate for cage identification.
- Headless Rendering -- CPU Tachyon ray-traced PNGs with no display or GPU, returned inline as images. Works on laptops, servers, and HPC.
- Attended (GUI) Mode -- run fully offscreen (default), or set VMDHYDRATEMCPDISPLAY=gui to open a visible VMD window** and watch Claude load, color, rotate, and render your system live.
- GROMACS + LAMMPS -- one server ingests .gro/.xtc/.trr, LAMMPS .data/dump, PDB, DCD, mmCIF.
- Secure by Default -- filesystem allowlist + a Tcl command allowlist (not a bypassable denylist) + a loopback, token-gated control socket. No run_tcl foot-gun exposed.
- MCP-Native -- clean English tool names and typed outputs; works in Claude Desktop, Claude Code, and any MCP client.
Quick Start
[!IMPORTANT]
Requires a local VMD install (2.0b1 or 1.9.4+) — this server drives your VMD; no registry or package ships it. On macOS, VMD lives inside a .app, so set VMD_BIN if vmd isn't on your PATH. (The pure hydrate/measure tools still work without VMD.)
Install
Zero-install via uvx (recommended):
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Vmd Hydrate: common questions
- Is Vmd Hydrate MCP server safe?
- Yes, by our scan: it is graded A (88/100). Read the Vmd Hydrate safety report
- How do I install Vmd Hydrate?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Vmd Hydrate need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Vmd Hydrate maintained?
- The last commit was 124 days ago (2026-07-03). The latest release is v0.2.0.
- What can I use instead of Vmd Hydrate?
- Servers from other publishers that do the same job: Argent MCP server, gflow-cli MCP server and Buoy Gg MCP server.
- How does Vmd Hydrate compare with other Productivity MCP servers?
- safety score 88/100 (higher than 75% of 1,299 Productivity servers); tools 17 (the typical Productivity server has 7); tools that change things 12% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Vmd Hydrate
Same job from other publishers: the closest match first, then the best rated.
- ArgentDrive iOS Simulators, Android emulators, TVs and Electron/web apps from your coding agentnot reviewedWidely usedA
- gflow-cliDrive Google Flow from an agent: Veo video and Imagen image generationnot reviewedEstablishedA
- Buoy GgLet AI agents read and drive a running React Native or Flutter app through Buoy's devtools.not reviewedEstablishedA
- Unreal EngineEngineWire: drive the Unreal Editor (UE 5.0-5.8): levels, Blueprints, UI, materials, VFX and more.not reviewedEstablishedB
- MirroirDrive a stock iPhone via iPhone Mirroring: no Developer Mode, Xcode or WDA. LLM-free skill replay.not reviewedEstablishedC