Quantum Simulator

Name: Quantum Simulator
Author: YuChenSSR

@YuChenSSR

リポジトリ

Quantum Simulator について

for quantum computing

#quantum-simulator #quantum-circuit #docker

基本情報

カテゴリ

その他

ライセンス

MIT

トランスポート

stdio

公開者

YuChenSSR

投稿者

Yu Chen

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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