Quantum Simulator

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

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

✨ 主な機能

• ノイズモデル付きの量子計算シミュレータ
• OpenQASM 2.0 量子回路をサポート
• Qiskit を使用した量子回路シミュレーション
• 複数のノイズモデル（脱分極、熱緩和、読み出しエラー）をサポート
• カウント、状態ベクトル、可視化されたヒストグラムなど、複数の結果タイプ
• 事前に設定されたサンプル回路
• 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. Claude の設定ファイルを編集します。
   • 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"
      ]
    }
  }
}

4. 設定が完了したら、Claude クライアントを再起動または再接続して変更を適用します。

📚 MCP ツール

• 回路の実行 (run_circuit)：量子回路をシミュレートし、結果を返します。
• 状態の取得 (get_state)：現在の量子システムの状態を取得します。
• パラメータの設定 (set_params)：量子回路のパラメータを設定します。
• 測定 (measure)：システムを測定し、結果を出力します。

📚 リソース

• サンプルファイル：
  • examples/circuits/hello_world.qasm：基本的な量子回路のサンプル。
  • examples/configurations/default.json：デフォルトの MCP 設定ファイル。

💻 使用例

1. Docker をダウンロードしてインストールします。
2. イメージを取得します：docker pull ychen94/quantum-simulator-mcp:latest
3. コンテナを実行します：docker run -i --rm -v /tmp:/data -e HOST_OUTPUT_DIR="/tmp" ychen94/quantum-simulator-mcp:latest
4. CLI または統合開発環境を使用してシミュレータと対話します。

📚 トラブルシューティング

⚠️ 重要提示

Docker コンテナがすぐに終了する場合は、MCP STDIO トランスポートの要件である -i フラグを使用して標準入力を開いたままにすることを確認してください。

📄 ライセンス

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