PyMOL MCP server

This is a helper that connects your AI to PyMOL, a well-known program for looking at molecules in 3D. It runs quietly in the background, so your AI can load a structure, draw it, and hand you back a picture. It is handy for students and researchers who work with molecular files and want to skip the clicking.

What this MCP server does

You ask your AI something about a molecule, in plain words. The AI picks the right action from this helper, like loading a file or coloring part of the structure. The helper talks to PyMOL behind the scenes and does the work. Then it sends the result back, often as a picture you can see right in the chat. For water and ice structures it can also run deeper analysis, like finding cages and counting hydrogen bonds.

Click to zoom

What you can do with it

• Load a molecule file from your computer or fetch one from the Protein Data Bank
• Color, show, or hide parts of a structure
• Render a ray-traced picture and see it right in the chat
• Measure distances, angles, and twists between atoms
• Load a simulation trajectory and look at a chosen frame
• Find water cages in a hydrate structure and draw them as shapes
• Check hydrogen bonds and order parameters to tell hydrate, ice, and liquid apart

Try asking your AI

• “Load ./hydrate.gro, color the water by F4 order parameter, and render it.”
• “Load md.gro and traj.xtc, show the CO2 guests as spheres, and render frame 50.”
• “What is the mean hydrogen-bond coordination of the water in this structure?”
• “Load tests/fixtures/hydrate_sII.gro, find and mark the cages, hide the waters, and render.”

What it gives back to you

You get answers in the chat, often with a picture attached. The picture is a rendered image of the molecule, sent right into the conversation. For analysis steps you get numbers and short summaries, like how many cages of each type were found or the average number of hydrogen bonds per water. If you ask it to save a file, it writes a picture or structure file to your computer.

Before you start

Who it's for

Chemistry and biology students, researchers, and anyone who works with molecular structures or simulation files and wants quick pictures and analysis without learning PyMOL by hand.