create_quantum_stateLABSCO SUMMARY
Install the physics without installing LaTeX.
Splitting animation into an optional extra is the decision that makes this usable: most people want the quantum computation, and the visualisation stack is where cross-platform installs break. The core works immediately with no system dependencies, and there is a one-line check that tells you whether animation is available on your machine. The limits are stated too — Hilbert spaces beyond 1024 dimensions affect performance, and rendering needs real resources.
What it is
An MCP server pairing QuTip for quantum computation with Manim for publication-quality visualisation. States are created, evolved and measured server-side and referenced by id, so a multi-step calculation stays coherent across several tool calls.
What you get
- State creation across the usual families: pure kets, mixed density matrices, coherent, squeezed, thermal and Fock states —
create_quantum_state - Time evolution by four methods: unitary Schrödinger for closed systems, Lindblad master equation for open ones, Monte Carlo trajectories and stochastic continuous measurement —
evolve_quantum_system - Measurement and analysis: expectation values, variances, probability distributions and correlation functions —
measure_observable - Gate application with visualisation, covering single-qubit Pauli, Hadamard and rotations, two-qubit CNOT, CZ and SWAP, and parameterised rotations —
quantum_gate_sequence - Entanglement measures: von Neumann entropy, concurrence, negativity and mutual information —
calculate_entanglement - Animations rendered with Manim: Bloch sphere evolution, Wigner functions in phase space, state tomography, circuit execution and energy level populations —
animate_quantum_process
Requirements
Python 3.10 or higher. The README's install line names psianimator-mcp, which PyPI does not have. The core install covers all the computation and needs no system dependencies. Animation is a separate extra because Manim pulls in LaTeX, FFmpeg and Cairo: core is roughly 100MB against 2GB or more with the full animation stack. After installing, run psianimator-mcp setup to create the config directory and check which features are available, and psianimator-mcp claude-config to generate the client block. Transport is stdio by default or WebSocket with a host and port, configurable through PSIANIMATOR_TRANSPORT, PSIANIMATOR_HOST and PSIANIMATOR_PORT.
Setup effort
Build from source — git clone https://github.com/manasp21/PsiAnimator-MCP.git
USE CASES
01
Working through a qubit calculation step by step
Create the state, measure an observable on it, and keep referring to the same state id as the calculation develops.
02
Modelling an open system
Evolve the state under the Lindblad master equation or Monte Carlo trajectories, rather than assuming a closed system.
03
Teaching what a gate does
Apply the gate sequence and render the Bloch sphere evolution, so the transformation is visible instead of described.
04
Quantifying entanglement in a two-qubit state
Compute concurrence, negativity or von Neumann entropy over the state you built.
05
Producing a figure for a paper or a lecture
Animate the Wigner function or the state tomography with Manim, once the animation extra is installed.
6 tools
Listed in project docs. Your client may show a different list.
evolve_quantum_systemmeasure_observableanimate_quantum_processquantum_gate_sequencecalculate_entanglementBEFORE YOU INSTALL
What to know first
Tools you get
6 tools named in the project's documentation.
Requires
- python3 on PATH
- Python ≥ 3.10
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
This one is built from source rather than installed with a single command.
Server setup
TERMINAL
git clone https://github.com/manasp21/PsiAnimator-MCP.git
cd PsiAnimator-MCP
pip install -e .MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"psianimator-mcp": {
"command": "python3",
"args": [
"-m",
"psianimator_mcp.cli",
"serve"
],
"env": {
"PSIANIMATOR_CONFIG": "~/.config/psianimator-mcp/config.json"
}
}
}
}
