Quantum Simulator

🚀 量子シミュレータ MCP サーバ

この Docker イメージは、モデルコンテキストプロトコル (MCP) をサポートする量子回路シミュレータを提供し、MCP クライアント（例えばデスクトップ版の「Claude」）と統合することができます。

✨ 主な機能

• ノイズモデルをサポートする量子計算シミュレータ
• OpenQASM 2.0 量子回路をサポート
• Qiskit を使用した量子回路シミュレーション
• 複数のノイズモデルのサポート（depolarizing、熱緩和、読み出し誤差）
• カウント、状態ベクトル、可視化されたヒストグラムなど、複数の結果タイプ
• 事前に設定されたサンプル回路
• MCP クライアントとのシームレスな統合

🚀 クイックスタート

Docker イメージを取得するには、以下のコマンドを実行します。

docker pull ychen94/quantum-simulator-mcp:latest

コンテナを実行するには、以下のコマンドを使用します。

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

このコマンドは以下のことを行います。

• ホストの /tmp ディレクトリをコンテナの /data/quantum_simulator_results にマウントします。
• HOST_OUTPUT_DIR 環境変数を /tmp に設定します。
• インタラクティブモードでコンテナを実行し続けます（ -i）。
• コンテナが終了したら自動的に削除します（ --rm）。

💻 使用例

デスクトップ版 Claude との統合

1. デスクトップ版 Claude をインストールします。
2. 設定ファイルを編集します。
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
3. mcpServers セクションに以下の設定を追加します。

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

Claude を使用した例

1. デスクトップ版 Claude を起動します。
2. 以下のプロンプトを入力します。

/quantum/simulator run_circuit "回路名称"

3. visualize_circuit コマンドを使用して量子回路の構造を確認します。

/quantum/simulator visualize_circuit "回路名称"

📚 ドキュメント

MCP ツール

• run_circuit：量子回路を実行します。
• list_noise_models：サポートされているノイズモデルをリストします。
• get_result：計算結果を取得します。
• visualize_circuit：回路を可視化します。
• save_circuit：回路設定を保存します。

リソース

• サンプル回路には、Bell 状態、Grover アルゴリズム、Deutsch - Jozsa アルゴリズムが含まれています。
• 事前に設定されたノイズモデルは、depolarizing と熱ノイズをサポートしています。

ボリュームマッピング

• /tmp：中間結果と出力ファイルを保存するために使用され、デフォルトでコンテナの /data/quantum_simulator_results にマウントされます。

環境変数

• HOST_OUTPUT_DIR：出力ディレクトリを指定します。ボリュームマッピングのパスと一致するように設定してください。

マルチアーキテクチャサポート

• サポートされているプラットフォーム：linux/amd64 と linux/arm64
• amd64 と arm64 アーキテクチャの CPU に対応

トラブルシューティング

1. コンテナがすぐに終了する場合：
   • -i フラグを使用して標準入力を開いたままにすることを確認してください。これは MCP STDIO トランスポートの要件です。
2. 出力ディレクトリが見つからない場合：
   • HOST_OUTPUT_DIR が正しく設定されていることを確認し、ボリュームマッピングのパスと一致するようにしてください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細については、プロジェクトリポジトリ の LICENSE ファイルを参照してください。