MCP server that exposes VMD2 (Visual Molecular Dynamics) control tools to Claude for molecular structure visualization, trajectory analysis, and rendering.
Server has 21 tools with complete schemas and descriptions. Naming follows verb_noun convention (load_, delete_, set_, get_, measure_, etc.). Descriptions are present and contextual (avg ~150 chars), exceeding the 10-char minimum. However, parameter descriptions lack specificity on constraints (e.g., 'mol_id' has no range guidance; 'selection' references VMD syntax but doesn't explain valid patterns). Output schemas are not documented, callers don't know what fields to expect from measure_distance or get_atom_info. Error handling is minimal; no recovery guidance or actionable error messages visible. Security concern: run_tcl_command blocks dangerous commands but doesn't validate selection strings or file paths against injection. Composition is sound, tools are single-purpose and chainable. Baseline: avg tool description ~150 chars (within 10-1024 range), all params have types, but ~40% of params lack descriptions or have generic ones.
Add a new visual representation to a molecule WITHOUT removing existing ones. Useful to show, e.g., the protein as cartoon AND the ligand as licorice simultaneously.
Remove a molecule from VMD by its molecule ID.
Remove a specific representation (by its index) from a molecule.
Retrieve atom information (index, residue name, residue ID, atom name) for atoms matching a selection.
Return the number of trajectory frames loaded for a given molecule.
Retrieve the version string of the running VMD instance.
Jump the trajectory of a molecule to a specific frame number.
Output schemas not documented. Tools like measure_distance, get_atom_info, list_loaded_molecules return data but callers don't know field names, types, or structure. LLMs cannot plan downstream calls or extract data reliably.
Parameter descriptions lack constraint details. 'mol_id' has no range guidance; 'selection' references VMD syntax but doesn't explain valid patterns (e.g., 'protein', 'resname LIG', 'backbone'); 'color' accepts arbitrary strings with no enum or valid values list.
No error handling guidance. Tool descriptions don't explain what happens on failure (e.g., invalid mol_id, file not found, VMD disconnected). No recovery hints for LLMs.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 54 | <=2025-11-25 | v2 |
Return all molecule IDs currently loaded in VMD along with their names and frame counts.
Load a molecular structure file into VMD. Supports PDB, PSF, GRO, MOL2, XYZ, and other VMD-compatible formats. Returns the molecule ID assigned by VMD.
Load a topology file together with a trajectory (DCD, XTC, TRR, etc.). The topology provides atom names/residues; the trajectory provides coordinates over time.
Measure the angle (in degrees) formed by three atoms.
Measure the distance (in Ångströms) between two atoms by their indices.
Measure the root-mean-square deviation (RMSD) between the current frame and a reference frame for a given atom selection.
Animate the trajectory of a molecule between two frames.
Render the current VMD scene to an image file using a specified renderer (e.g., TachyonInternal, POV-Ray).
Center all loaded molecules and reset the camera to the default view.
Execute an arbitrary Tcl command in VMD's interpreter. Dangerous commands (exec, open, file, socket, package, source, load, unload, exit, quit, proc, namespace, interp, vwait) are blocked for security. The command must not contain top-level semicolons (send one command at a time).
Save the current VMD session (all loaded molecules, representations, and view settings) to a .vmd state file.
Set the VMD background color, e.g. black, white, gray, blue.
Replace all visual representations of a molecule with a single new one. style can be: NewCartoon, Licorice, VDW, Ribbons, Surf, QuickSurf, Lines, Bonds, CPK, etc. selection uses VMD atom selection language, e.g. 'protein', 'resname LIG', 'backbone', 'all'. color_method: Name, Element, ResType, ResID, Beta, Occupancy, ColorID 0, etc.
Stop any ongoing trajectory animation.
run_tcl_command blocks dangerous commands but doesn't validate selection strings or file paths. Injection via 'selection' parameter in set_representation or get_atom_info could bypass Tcl restrictions.
No idempotency guarantees. Tools like load_structure, delete_molecule, and render_image don't document retry behavior. Agents retrying on ambiguous failures risk duplicate loads or renders.