PsiAnimator

PsiAnimator MCP Server combines quantum physics computation with high-quality visualizations. It lets you perform state evolution, measurements, and entanglement analysis using QuTip, while generating publication-ready animations with Manim. This server is designed for education and research, with a flexible MCP interface that works with compatible clients.

How to use

You interact with the PsiAnimator MCP Server through an MCP-compatible client. Start the local server using the standard command, then connect your client to the server to create quantum states, evolve them, and gather measurements. Use the animation features to generate visualizations such as Bloch spheres, Wigner functions, and circuit executions. You can perform single-qubit and multi-qubit operations, compute entanglement measures, and render results as animations for sharing or publication.

How to install

Prerequisites: Python 3.10 or newer is required. Git is needed for development installations.

# Core installation (quantum computation features only)
pip install psianimator-mcp

# Full installation with visualization support
pip install "psianimator-mcp[animation]"

# Development installation
git clone https://github.com/username/PsiAnimator-MCP.git
cd PsiAnimator-MCP
pip install -e ".[dev,animation]"

Additional sections

Configuration and environment setup are designed to be straightforward. You can tune quantum precision, maximum Hilbert space size, and output rendering options. The setup also covers how to integrate with Claude Desktop for quick desktop access.

Environment variables let you customize where the server runs, how it transports data, and how animations are stored. You can set these variables to define the MCP transport, host, port, and quantum calculation settings.

The server exposes a set of practical tools for quantum work, including state creation, time evolution, measurements, animation generation, gate sequences, and entanglement calculations. See the Tools section for detailed capabilities and usage patterns.

If you plan to run animations, ensure system dependencies for rendering are installed (LaTeX, FFmpeg, Cairo). The animation stack adds heft to the installation but enables rich visual output.

Troubleshooting common issues: verify the core components load correctly, confirm the correct transport is selected, and install optional animation dependencies if you require visualization features.

Claude Desktop integration can be generated automatically or configured manually to connect with Claude Desktop for streamlined control.

Available tools

create_quantum_state

Create quantum states of various types such as pure, mixed, coherent, squeezed, thermal, and Fock states.

evolve_quantum_system

Time evolution using unitary dynamics, master equations, Monte Carlo trajectories, or stochastic continuous measurements.

measure_observable

Perform measurements to obtain expectation values, variances, probability distributions, and correlations.

animate_quantum_process

Generate Manim animations for Bloch sphere evolution, Wigner functions, state tomography, circuit execution, and energy level dynamics.

quantum_gate_sequence

Apply single- and multi-qubit gates with visualization and circuit-level animation.

calculate_entanglement

Compute entanglement measures such as Von Neumann entropy, concurrence, negativity, and mutual information.