Quantum Simulator

What is Quantum Simulator?

A Docker image that provides a quantum circuit simulator implementing the Model Context Protocol (MCP) for integration with MCP clients like Claude for Desktop. It simulates quantum circuits with noise models using Qiskit.

How to use Quantum Simulator?

Pull the Docker image (docker pull ychen94/quantum-simulator-mcp:latest), then run the container with docker run -i --rm -v /tmp:/data/quantum_simulator_results -e HOST_OUTPUT_DIR=/tmp ychen94/quantum-simulator-mcp:latest. Configure the container as an MCP server in your Claude for Desktop configuration file (claude_desktop_config.json).

Key features of Quantum Simulator

• Quantum computing simulator with noise models
• Support for OpenQASM 2.0 quantum circuits
• Quantum circuit simulation using Qiskit
• Various noise models (depolarizing, thermal relaxation, readout error)
• Multiple result types (counts, statevector, histograms)
• Pre-configured example circuits

Use cases of Quantum Simulator

• Run a Bell state circuit and inspect the results
• Simulate Grover's algorithm with configurable noise
• Explore available noise models and their descriptions
• Generate and visualize histogram output files

FAQ from Quantum Simulator

What architectures are supported?

The image supports linux/amd64 and linux/arm64 (confirmed on Mac M-series). It has not been tested on Windows but should work with proper Docker Desktop configuration.

How do I access histogram files from the host?

Histogram PNG files are generated inside the container at /data/quantum_simulator_results and made available on the host through the volume mapping. Ensure HOST_OUTPUT_DIR matches the host path in your -v mapping.

Why does the Docker container exit immediately?

The container requires the -i flag to keep stdin open for MCP STDIO transport. Without it, the container will exit immediately.

What environment variables control the output directory?

QUANTUM_OUTPUT_DIR sets the output directory inside the container (default /data/quantum_simulator_results), and HOST_OUTPUT_DIR sets the corresponding host path (default /tmp).