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 配置文件。

📄 许可证

本项目在 MIT 许可证下发布。更多详细信息，请参阅 此项目仓库 中的 LICENSE 文件。

🔧 故障排除

• 问题：Docker 容器立即退出。
• 解决方法：确保使用了 -i 标志以保持标准输入打开，这是 MCP STDIO 运输的要求。