Psi-MCP: Advanced Quantum Systems

Psi-MCP is an advanced MCP server for quantum systems analysis and simulation. It provides tools for quantum circuits, open quantum systems, quantum chemistry, many-body physics, quantum machine learning, and quantum field theory, enabling you to model, simulate, and visualize complex quantum phenomena.

How to use

You access the server through an MCP client and run tasks by choosing the appropriate tools provided by Psi-MCP. You can create quantum circuits, simulate their behavior on various backends, and retrieve results such as state vectors or measurement counts. You can also solve open system dynamics, perform quantum chemistry calculations like VQE, and explore many-body physics with methods such as DMRG. Visualization tools let you inspect Bloch spheres, density matrices, and Wigner functions to gain intuition about quantum states.

How to install

Prerequisites: install Python 3.11 or higher, Docker for containerized deployment, and Git.

Local development steps you can follow to run Psi-MCP locally:

# Clone the repository
git clone https://github.com/manasp21/Psi-MCP.git
cd Psi-MCP

# Install dependencies
pip install -r requirements.txt

# Run the server
python src/server.py

Additional sections

Configuration options are exposed for backend choice, qubit limits, precision, and time/memory constraints to tailor the server to your hardware and needs.

Environment variables you may set for deployment include server port, host, default computing backend, and default qubit settings.

If you prefer containerized deployment, you can build and run a container with the provided image and environment configuration.

Examples show how to create circuits, run simulations, and perform higher-level workflows that combine circuit creation, simulation, visualization, and entanglement analysis.

Available tools

create_quantum_circuit

Create quantum circuits with specified qubit counts and circuit types for target backends.

simulate_quantum_circuit

Simulate quantum circuits and retrieve results such as measurement counts or state vectors.

solve_master_equation

Solve open quantum system dynamics using master equations, including Lindblad form.

analyze_decoherence

Analyze decoherence effects given system Hamiltonian and environment coupling.

vqe_chemistry

Run variational quantum eigensolver calculations to obtain electronic structure properties.

generate_molecular_hamiltonian

Generate molecular Hamiltonians for specified molecules and basis sets.

dmrg_simulation

Perform density matrix renormalization group calculations for many-body systems.

vqe_optimization

Optimize VQE parameters using various optimizers for target Hamiltonians.

grovers_search

Execute Grover’s search algorithm for marked items in a given search space.

shors_algorithm

Factor integers using Shor’s algorithm on suitable backends.

visualize_quantum_state

Visualize quantum states via Bloch spheres, density matrices, and Wigner functions.