Verify Docker has permissions to write to the mount location

check the mcp tool's output content find the pic then open it in the terminal or your picture viewer.

⭐️ ⭐️ I use the iterm-mcp-server or other terminals' mcp servers to open the file without interrupting your workflow. ⭐️ ⭐️

Support

If you encounter issues, please open a GitHub issue with:

Error messages
Your operating system and Docker version
Steps to reproduce the problem

License

This project is licensed under the MIT License.
For more details, please see the LICENSE file in this project repository.

1d:T174d,

Quantum Simulator MCP Server

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.

Features

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
Pre-configured example circuits
Seamless integration with MCP clients

Quick Start

get the docker image

docker pull ychen94/quantum-simulator-mcp:latest

Simply run the container with the following command:

docker run -i --rm -v /tmp:/data/quantum_simulator_results -e HOST_OUTPUT_DIR="/tmp" ychen94/quantum-simulator-mcp:latest

This command:

Mounts the /tmp directory on your host to store histogram output files
Sets the HOST_OUTPUT_DIR environment variable to /tmp
Keeps the container running with -i (interactive mode)
Automatically removes the container when it exits with --rm

Using with Claude for Desktop

Install Claude for Desktop
Edit the Claude configuration file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the following configuration to the mcpServers section:

{
  "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"
      ]
    }
  }
}

Restart Claude for Desktop
Look for the hammer icon in the Claude UI, indicating available MCP tools

MCP Tools

The server provides the following MCP tools:

run_circuit: Run a quantum circuit with specified noise model
list_noise_models: List all available noise models and their descriptions
list_result_types: List all available result types and their descriptions
get_circuit_stats: Analyze a quantum circuit and return statistics
create_test_histogram: Create a test histogram file to verify output directory configuration

MCP Resources

The server provides example quantum circuits:

qasm://examples/

Categories

Current Category: quantum-computing

symbolica-mcp

quantum-simulator-mcp