Quantum Simulator MCP Server

基本能力

产品定位

Quantum Simulator MCP Server 是一个量子计算模拟器，专为需要量子电路模拟的开发者和研究人员设计。

核心功能

• 量子计算模拟器，支持噪声模型
• 支持 OpenQASM 2.0 量子电路
• 使用 Qiskit 进行量子电路模拟
• 支持多种噪声模型（去极化、热弛豫、读出错误等）
• 多种结果类型，包括计数、状态向量和可视化直方图
• 预配置的示例电路
• 与 MCP 客户端的无缝集成

适用场景

• 量子算法开发和测试
• 量子电路模拟与验证
• 量子计算教学与研究
• 与 MCP 客户端（如 Claude for Desktop）集成的量子计算应用

工具列表

• run_circuit: 运行带有指定噪声模型的量子电路
• list_noise_models: 列出所有可用的噪声模型及其描述
• list_result_types: 列出所有可用的结果类型及其描述
• get_circuit_stats: 分析量子电路并返回统计信息
• create_test_histogram: 创建测试直方图文件以验证输出目录配置

常见问题解答

• 问题: Claude 无法访问直方图文件。 解决方案: 确保卷映射正确，并且 HOST_OUTPUT_DIR 环境变量与卷映射中的主机路径匹配。
• 问题: Docker 容器立即退出。 解决方案: 确保使用 -i 标志保持 stdin 打开，这是 MCP STDIO 传输所必需的。

使用教程

使用依赖

• 需要安装 Docker

安装教程

1. 获取 Docker 镜像

docker pull ychen94/quantum-simulator-mcp:latest

1. 运行容器

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

调试方式

• 确保容器运行正常，可以通过查看日志或检查输出文件来验证。
• 使用 create_test_histogram 工具验证输出目录配置。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。