Quantum Simulator

@YuChenSSR

About Quantum Simulator

for quantum computing

#quantum-simulator #quantum-circuit #docker

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "quantum-simulator": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "/tmp:/data/quantum_simulator_results",
        "-e",
        "HOST_OUTPUT_DIR=/tmp",
        "ychen94/quantum-simulator-mcp:latest"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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).

Frequently asked questions

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`).