Водите PyMOL на простом английском языке — из Codex, Claude Code, Cursor или вашего телефона.

** co-pymol** - это плагин PyMOL, который превращает PyMOL в MCP-сервер, поэтому вы можете управлять им на английском языке с любого клиента MCP (Codex, Claude Code, Cursor) вместо ввода команд PyMOL вручную. При запуске он раскручивает MCP-сервер, построенный на официальном MCP Python SDK, внутри собственного процесса Python PyMOL, раскрывая API pymol.cmd как инструменты, поэтому вы можете:

Автоматический анализ и визуализация с помощью агента вместо того, чтобы делать это вручную Читайте значения достоверности ** (pLDDT / ipTM / pTM / PAE) на окне агента через слой метрик с поддержкой гемми, который анализирует mmCIF Сбросьте своих помощников — наведите агента на .py пользовательских предустановок PyMOL / функций анализа и попросите его использовать их. ** Работа над кластерными дорожками, установленными SSHFS, как обычно Удаленное управление с телефона через MCP-клиент, поддерживающий удаленные сеансы

Демо-версия Codex

[[Т3]]

Пример сессии в Codex / Claude Code / Cursor:

Требования

co-pymol

Drive PyMOL in plain English — from Codex, Claude Code, Cursor, or your phone.

co-pymol is a PyMOL plugin that turns PyMOL into an MCP server, so you can drive it in English from any MCP client (Codex, Claude Code, Cursor) instead of typing PyMOL commands by hand. On startup it spins up an MCP server — built on the official MCP Python SDK — inside PyMOL’s own Python process, exposing the pymol.cmd API as tools, so you can:

• Automate analysis and visualisation with an agent instead of doing it by hand
• Read confidence values (pLDDT / ipTM / pTM / PAE) on an agent’s window via a gemmi-backed metrics layer that parses mmCIF
• Drop in your own helpers — point the agent at a .py of custom PyMOL presets / analysis functions and ask it to use them
• Work over SSHFS-mounted cluster paths as usual
• Remote-control from your phone through an MCP client that supports remote sessions

Codex demo

https://github.com/user-attachments/assets/bbbdbe32-bc59-4446-9bd1-3e4860af022e

An example session in Codex / Claude Code / Cursor:

> Load all the CIF files in /path/to/dir/w/predicted/structures/
[all the structures visible on PyMOL window]
Loaded all structures, sorted by mean pLDDT.

> Which one has the worst ipTM?
model_3 — ipTM 0.41 (others are 0.7+).

> Show me the low-confidence loops on structure_500.
[renders cartoon on PyMOL window, residues 142–168 highlighted, mean pLDDT 38]

Requirements

• PyMOL (a normal desktop install — the plugin installs into PyMOL’s bundled Python, not your system Python)
• An MCP client — Codex, Claude Code, or Cursor 3.12.17 or newer. Older Cursor versions may not refresh the tool list when PyMOL starts after Cursor.
• macOS — that’s all I’ve tested on :/ Linux / conda / non-standard installs should work in principle (the recipe is just “install into PyMOL’s bundled Python”) but these haven’t been tested.

Installing

If you prefer to have a coding agent (Claude Code, Cursor, Codex, etc.) do the install for you, point it at AGENTS.md — it’s the same recipe written for an agent to execute.

1. Clone and install

git clone https://github.com/soo-jeongkim/co-pymol.git
cd co-pymol
/Applications/PyMOL.app/Contents/bin/python -m pip install --user -e .

2. Set up the MCP client you use

Choose exactly one:

# Codex
/Applications/PyMOL.app/Contents/bin/python -m co_pymol setup codex

# Cursor
/Applications/PyMOL.app/Contents/bin/python -m co_pymol setup cursor

# Claude Code
/Applications/PyMOL.app/Contents/bin/python -m co_pymol setup claude

Each command installs the shared PyMOL startup hook and configures only the selected client. The other clients do not need to be installed. The Codex and Claude choices require their existing CLI on PATH; the Cursor choice writes ~/.cursor/mcp.json directly. These commands configure co-pymol for a client —