Overview
AmadeusBio.ai is a coding agent (i.e Claude Code) based plugin that provides the instructions and protocols for agents to perform bioinformatic analysis.
Demo
Current features include:
- Operate local softwares such as PyMol and napari using natural language.
- Retrival of sequences, protein structures etc. from databases including Uniprot.
- Remote operation of usegalaxy.org.
- Plus everything that come with coding agent.
Get Started
Install as a Claude Code plugin
Clone the repo, then point Claude Code at it with --plugin-dir:
git clone https://github.com/AmadeusBio-ai/mvp.git
claude --plugin-dir ./mvpInside Claude Code, the bundled skills are available under the amadeusbio-mvp: namespace, e.g. /amadeusbio-mvp:pymol-molecular-visualization. The two agents (PyMol-Software-Operator, protein-structure-downloader) are auto-discovered and triggered by description-match.
PyMOL side (one-time, only if you use the PyMOL agent)
The pymol-molecular-visualization skill talks to a live PyMOL session over localhost:9876. Install the PyMOL-side plugin once:
- Open PyMOL →
Plugin→Plugin Manager→Install New Plugin. - Select the
pymol-mcp-socket-plugin/directory in this repo. - Restart PyMOL. Verify with
pymol -d "mcp_start"from a terminal.
See PyMol-Integration for full setup instruction on Windows/macOS/Linux.
Napari side (one-time, only if you use the Napari agent)
To prevent dependency conflicts, Napari and its MCP plugin must be installed in an isolated virtual environment.
See Napari Integration & Setup for detailed isolation and configuration steps.
Galaxy-plugin
Install galaxy-plugin to allow Claude Code to remotely operate usegalaxy.org.
git clone https://github.com/AmadeusBio-ai/galaxy-plugin.git
claude --plugin-dir ./galaxy-pluginPrerequisites
uv/uvxinstalled and on PATH.- A Galaxy API key — get one at
User → Preferences → Manage API Keyon usegalaxy.org (or whatever Galaxy instance you use).
See galaxy-plugin for step by step set up process.
Credits & Acknowledgments
| Project | Author / Repository | How it was used |
|---|---|---|
| SciAgent-Skills | jaechang-hits/SciAgent-Skills | Utilized skills |
| pymol-mcp | vrtejus/pymol-mcp | Adapted for PyMol integration |
| napari-mcp | royerlab/napari-mcp | Integrated capabilities |
| galaxy-mcp | galaxyproject/galaxy-mcp | remote control galaxy |
| Agent Monitor | hoangsonww/Claude-Code-Agent-Monitor | Adapted for the Agents dashboard |
| Fumadocs | fuma-nama/fumadocs | Website built using this template |