Quantum Simulator MCP Server logo

Quantum Simulator MCP Server

by YuChenSSR

A Docker image providing a quantum circuit simulator that implements the Model Context Protocol (MCP), allowing integration with MCP clients such as Claude for Desktop. It supports simulating quantum circuits with noise models using Qiskit.

View on GitHub

Last updated: N/A

What is Quantum Simulator MCP Server?

This is a quantum circuit simulator packaged as a Docker image. It uses Qiskit to simulate quantum circuits and supports integration with MCP clients like Claude for Desktop, enabling users to run quantum simulations directly from their desktop environment.

How to use Quantum Simulator MCP Server?

To use this server, first pull the Docker image. Then, run the container with the provided command, ensuring to mount a volume for storing histogram output files. Configure Claude for Desktop by adding the server configuration to the mcpServers section of the Claude configuration file. Restart Claude and use the MCP tools.

Key features of Quantum Simulator MCP Server

  • Quantum computing simulator with noise models

  • Support for OpenQASM 2.0 quantum circuits

  • Quantum circuit simulation using Qiskit

  • Support for various noise models (depolarizing, thermal relaxation, readout error)

  • Multiple result types including counts, statevector, and visualized histograms

Use cases of Quantum Simulator MCP Server

  • Simulating quantum algorithms

  • Experimenting with different noise models

  • Integrating quantum simulations with natural language interfaces

  • Analyzing quantum circuit statistics

FAQ from Quantum Simulator MCP Server

How do I access the histogram files generated by the simulator?

Ensure the volume mapping is correctly configured in the Docker run command. The files will be available in the host path specified in the volume mapping.

Why does the Docker container exit immediately?

Make sure to include the -i flag in the Docker run command to keep stdin open, which is required for the MCP STDIO transport.

What quantum circuits are available as examples?

The server provides example quantum circuits such as Bell state preparation, 2-qubit Grover's algorithm, and 4-qubit Quantum Fourier Transform.

How do I specify a noise model for the simulation?

Use the run_circuit MCP tool and specify the desired noise model from the available list. You can use the list_noise_models tool to see the available options.

What architectures are supported by this image?

This image supports linux/amd64 and linux/arm64 architectures. It has been confirmed to work on Mac M-series chips.