MCP.Market

Vmd Hydrate MCP server

by wjgoarxiv·io.github.wjgoarxiv/vmd-hydrate-mcp·v0.2.0

Drive VMD for GROMACS/LAMMPS analysis + clathrate-hydrate cage science (needs a local VMD)

A88/100grade A
What users say
No reviews yet
Be the first
Safety scan
A88/100

full report

Adoption
New

0 stars24 downloads/wk

Reviews

Write one

Nobody 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 posts

Read from the package source without running it. The installed server may list more.

  • add_representation

    Add 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 action

    Remove all representations from a molecule (start a fresh view).

  • hbond_network

    Build 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 action

    Compute 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_cages

    Identify 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_molecules

    List molecules currently loaded in the VMD session (molid, path, atoms, frames).

  • load_structure

    Load 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_geometry

    Measure a distance (2 atom indices), angle (3), or dihedral (4) at a frame. Distances are in Angstrom, angles in degrees.

  • radius_of_gyration

    Radius of gyration (Angstrom) of an atom selection at a frame.

  • render

    Render the current view of a loaded molecule headlessly (CPU Tachyon) and return a PNG image. Resolution is capped for safety.

  • render_cages

    Render 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_view

    Reset/fit the camera to the loaded molecule.

  • resolve_selection

    Report how many atoms an MDAnalysis selection matches — use this to catch the common 0-atom trap on bare .gro files before running measurements.

  • rotate_view

    Rotate 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_representation

    Set 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_status

    Report whether VMD is available, its version, and the molecules currently loaded in the persistent session.

  • zoom_view

    Zoom 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

no findings
  • 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
Overall 88/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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.

  • Argent
    Drive iOS Simulators, Android emulators, TVs and Electron/web apps from your coding agent
    A
  • gflow-cli
    Drive Google Flow from an agent: Veo video and Imagen image generation
    A
  • Buoy Gg
    Let AI agents read and drive a running React Native or Flutter app through Buoy's devtools.
    A
  • Unreal Engine
    EngineWire: drive the Unreal Editor (UE 5.0-5.8): levels, Blueprints, UI, materials, VFX and more.
    B
  • Mirroir
    Drive a stock iPhone via iPhone Mirroring: no Developer Mode, Xcode or WDA. LLM-free skill replay.
    C