MCP.so
Sign In

Quantum Simulator MCP Server

@YuChenSSR

Basic information

Category

Other

License

MIT

Transports

stdio

Author

YuChenSSR

Submitted by

Yu Chen

About Quantum Simulator MCP Server

for quantum computing

#quantum-simulator#quantum-circuit#docker

Quantum Simulator MCP Server 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"
      ]
    }
  }
}

Quantum Simulator MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

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.

2

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.

3

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.

4

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

Comments

More Other MCP servers