Quantum Simulator

🚀 量子模擬器 MCP 服務器

量子模擬器 MCP 服務器是一個 Docker 鏡像，提供實現模型上下文協議（MCP）的量子電路模擬器。它支持與 MCP 客戶端（如桌面版的Claude）集成，為量子計算模擬提供了便捷的解決方案。

🚀 快速開始

獲取 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）。

✨ 主要特性

• 帶有噪聲模型的量子計算模擬器。
• 支持 OpenQASM 2.0 量子電路。
• 使用 Qiskit 進行量子電路模擬。
• 支持多種噪聲模型（去極化、熱鬆弛、讀出錯誤）。
• 多種結果類型，包括計數、狀態向量和可視化的直方圖。
• 預配置示例電路。
• 與 MCP 客戶端無縫集成。

📦 安裝指南

與桌面版 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 客戶端以應用更改。

💻 使用示例

基礎用法

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 或集成開發環境與模擬器交互。

📚 詳細文檔

MCP 工具

• 運行電路 (run_circuit)：模擬量子電路並返回結果。
• 獲取狀態 (get_state)：獲取當前量子系統的狀態。
• 設置參數 (set_params)：配置量子電路的參數。
• 測量 (measure)：對系統進行測量並輸出結果。

資源

• 示例文件：
  • examples/circuits/hello_world.qasm：基本量子電路示例。
  • examples/configurations/default.json：默認 MCP 配置文件。

🔧 技術細節

故障排除

• 問題：Docker 容器立即退出。
  • 解決方法：確保使用了 -i 標誌以保持標準輸入打開，這是 MCP STDIO 運輸的要求。

📄 許可證

本項目在 MIT 許可證下發布。更多詳細信息，請參閱 此項目倉庫 中的 LICENSE 文件。