openQuantum MCP Client

Use This MCP client To

Start a quantum computing task with a simple sentence Analyze and compare quantum circuits Query available quantum hardware and cloud backends Run quantum algorithms and get detailed results Check quantum task execution steps and validations Connect quantum tools inside WeChat or Feishu chat apps Explore and compare quantum SDKs and algorithms

README

量子计算，就在指尖
_{Quantum computing, right at your fingertips.}

从网页到微信，用一句话连接量子算法、工具与云端后端

MIT License Node.js 24 or newer MCP ready

快速开始 · 量子能力 · 扩展开发 · 项目故事 · 参与贡献

打开网页，或者把 OpenQuantum 接入微信、飞书，你就可以用一句话开始一项量子任务。让 Agent 分析量子电路、查询量子云后端、运行算法，再把结果和完整过程交还给你。

这就是 OpenQuantum，一个开源的量子 Agent 工作台。它把原本散落在代码、文档、云平台和设备接口里的量子能力，放进同一个看得见、用得上的入口。

你可以直接使用已经集成的 Qiskit、FieldQKit、本源量子（OriginQ / QPanda）和量子算法能力，也可以把自己的设备、数据、方法和模型做成 Skill 或 MCP，交给同一个 Agent 调用。普通用户可以从自然语言开始，研究机构可以组织科研工作流，量子公司也可以在这套基础上继续开发自己的产品。

OpenQuantum 基于 DeepSeek Harness 构建。Harness 提供会话、工具调度、权限、持久化和执行轨迹，OpenQuantum 在上面组织量子工具、算法 Skill、科学验收和更适合量子工作的产品界面。

OpenQuantum 的第一版，是在 DeepSeek Harness 发布后的三天里做出来的。它从一个很直接的想法开始，把散落在不同仓库、云平台和文档里的量子工具放进同一个工作台，让用户可以直接使用，也让研究机构和量子公司可以继续接入自己的能力。

一句话开始
从网页、微信或飞书发出请求，分析电路、查询后端、运行算法。

每一步看得见
工具调用、权限状态、计算结果和科学检查都保留在任务轨迹里。

能力可以生长
沿用 Skill、MCP 等开放方式，继续接入设备、算法和科研工作流。

让微信成为量子计算的入口

量子计算过去常常从安装 SDK、配置环境和翻文档开始。OpenQuantum 希望把入口往前推一步。配置好消息渠道后，你可以直接在微信或飞书里发出一条消息，让同一个 OpenQuantum Agent 去调用量子工具。

你在微信里提出问题
  → OpenQuantum 判断应该使用哪个 Skill
  → DeepSeek Harness 调用 Qiskit、量子算法或云端 MCP
  → 结果回到对话，完整执行轨迹留在工作台

你可以让它检查一段 OpenQASM 电路，比较不同转译方案，查询 IBM Quantum、IonQ 或国内量子云后端，也可以运行 OpenQuantum 已验收的量子基态算法。需要真实硬件或付费服务时，再由使用者配置对应凭据并明确开启。

手机负责提出问题，OpenQuantum 负责连接工具，DeepSeek Harness 负责把整个过程可靠地跑起来。

量子计算，就在指尖。

从一个真实任务开始

下面是一段 OpenQuantum 的实际运行记录。Agent 完成了一次二量子位基态任务，先用 VQE 求解，再用独立计算检查结果。任务结果、工具调用和科学验收都保留在同一条轨迹里。

-1.85727503 Ha
_{VQE 能量}

-1.85727503 Ha
_{独立精确参考}

4.44 × 10⁻¹⁶ Ha
_能量差

通过
_科学验收

OpenQuantum 运行量子基态任务并完成科学检查

_{真实运行画面　从任务结果到独立科学检查}

已集成的量子工具与能力

这里既有 Qiskit 提供的官方 MCP，也有 FieldQKit、Quantum Hardware MCP 等社区项目，还有本源量子（OriginQ / QPanda）的官方运行时 MCP、编程 Skill 与本地 QUBO 算法桥，以及 OpenQuantum 自己维护的算法 Skill 和科学 Validator。每一项都写明了来源、集成方式和默认状态，方便使用，也方便后续维护和扩展。

组件	来源与集成方式	可以完成的事情	默认状态
Qiskit Circuits	Qiskit 官方 MCP · 原版接入 + OpenQuantum Skill	创建、读取、转换和分析 OpenQASM 3 / QPY 电路，比较转译结果	开启，无需凭据
Qiskit Docs	Qiskit 官方 MCP · 原版接入	查询 Qiskit API、迁移说明、错误码和 IBM Quantum 文档	开启，无需凭据
FieldQKit	FieldQuantum · 固定上游提交 + 只读桥接	发现国内量子云后端，按量子位筛选，查看拓扑和校准摘要	开启，只读
TyxonQ Local	TyxonQ · 固定 PyPI 版本 + 本地 MCP + OpenQuantum Skill	运行小规模 statevector 电路、有限 shots 与 density-matrix 噪声仿真	接入，关闭
IBM Runtime	Qiskit 官方 MCP · 原版接入 + 凭据设置	查询 IBM 后端，向 IBM Quantum 提交任务	接入，关闭
IBM Transpiler	Qiskit 官方 MCP · 原版接入 + 凭据设置	使用 IBM Quantum AI Transpiler 路由和优化电路	接入，关闭
Quantum Hardware MCP	社区项目 · 固定审阅提交 + 安全开关	查询 IBM Quantum 与 IonQ 设备，可选提交、取消任务和估算成本	接入，关闭
QPanda3 Runtime	OriginQ 官方 MCP · 固定审阅提交 + 凭据设置	查询本源悟空 QPU 设备，向本源量子云提交采样、期望值与批量任务并管理任务	接入，关闭
QPanda3 编程 Skill	OriginQ 官方 Skill · 固定提交检出到 .agents/skills	pyqpanda3 电路构建、QAOA/Grover/VQE/QSVM 算法模板、pyqpanda→pyqpanda3 迁移与 QCloud 使用指导	接入，需运行 setup
QPanda QUBO	pyqpanda_alg · 固定版本 + 本地 MCP 桥 + OpenQuantum Skill	本地 CPU 求解小规模 QUBO：经典暴力遍历最优解 + 可选 QAOA 变分近似，含目标函数自洽检查	接入，关闭
Qiskit Gym	Qiskit 官方 MCP · 原版接入	探索强化学习量子电路综合与优化	接入，关闭
量子基态求解	OpenQuantum 自研 · Skill + MCP + Validator	求解限定的二量子位 Hamiltonian，并与独立精确解比较	开启，本地运行
量子 SDK 选型	OpenQuantum 自研 · Skill	比较 Qiskit、Cirq、PennyLane、Q#、Braket、CUDA-Q 等工具	开启

第三方组件保留原项目的版权与许可证。对应的版本、来源和 OpenQuantum 集成内容记录在 THIRD_PARTY_NOTICES.md。


_{量子组件、Skill、MCP 与安全凭据}	_{从用户请求追溯到 MCP 工具结果}

可以连接哪些量子后端

OpenQuantum 已经为本地模拟、IBM Quantum、IonQ 和多家国内量子云准备了入口。每个平台当前可以做什么、需要什么凭据，都可以在这里直接看到。

后端	当前能力	凭据或使用条件
本地模拟器	查看模拟器元数据，运行本地量子基态参考能力	无需凭据
IBM Quantum	Runtime、AI Transpiler、硬件查询，可选真实任务提交与取消	`QISKIT_IBM_TOKEN`，任务类 MCP 按需开启
IonQ	硬件查询，可选真实任务提交、取消与成本估算	`IONQ_API_KEY`，任务类 MCP 按需开启
夸父量子云	凭据检查、后端发现、量子位筛选、拓扑与校准摘要	`QUAFU_API_TOKEN`，只读
天衍量子云	凭据检查、后端发现、量子位筛选、拓扑与校准摘要	`TIANYAN_API_TOKEN`，只读
国盾量子云	凭据检查、后端发现、量子位筛选、拓扑与校准摘要	`GUODUN_API_TOKEN`，只读
腾讯量子云	凭据检查、后端发现、量子位筛选、拓扑与校准摘要	`TENCENT_API_TOKEN`，只读
本源量子云	只读后端发现（FieldQKit）；另经 QPanda3 Runtime MCP 查询悟空 QPU，并可选提交采样、期望值与批量任务	`ORIGIN_API_TOKEN` 只读发现；`QPANDA3_API_KEY` 可选开启真机任务
FieldQuantum	云端模拟后端发现	`FIELDQUANTUM_API_TOKEN`，只读
逻辑比特量子云	凭据检查、后端发现、量子位筛选、拓扑与校准摘要	`LOGICALQUBIT_API_TOKEN`，只读

硬件任务和付费服务按需开启。后端发现类能力保持只读，适合先了解设备、拓扑和校准信息，再决定是否进入真实任务流程。

国产量子云正在从“只读发现”走向“真机执行”：本源量子（OriginQ）官方的 QPanda3 Runtime MCP 已经接入，默认关闭。运行 npm run mcp:qpanda-runtime:setup 检出固定审阅提交，在设置中心配置 QPANDA3_API_KEY 并手动开启后，即可连接悟空真机。完整的本源生态候选与取舍见量子能力清单。

每一步，都看得见

做量子任务时，一个结果往往不够。OpenQuantum 会把用户请求、Skill 加载、工具调用、权限状态和返回结果连成一条清晰的执行轨迹。

使用者可以知道 Agent 调用了什么，开发者也可以沿着这条轨迹定位模型、工具、权限和外部服务中的问题。对科研工作来说，这份过程记录和最终数字一样重要。

运行完成之后，还有科学验收

OpenQuantum 把任务运行和科学验收分开显示。quantum-ground-state 是一个小而完整的参考能力，它在固定扇区内运行二量子位无噪声 statevector VQE，再用独立程序检查能量、态矢、收敛轨迹和数值残差。

当前的科学边界是明确限定的二量子位实 Pauli Hamiltonian。这个例子展示了一项量子能力怎样从计算、证据一路走到可复核的结论，也为社区开发更丰富的算法 Skill 和 Validator 提供了可以直接参考的起点。

快速开始

准备 Node.js 24，以及用于启动 Qiskit 工具的 uv / uvx。

git clone https://github.com/xi-zhao/openQuantum.git
cd openQuantum
npm ci
cp .env.example .env
npm run dev

浏览器打开 http://127.0.0.1:3000。

模型地址、模型密钥、MCP、Skill 和量子云凭据都可以从设置中心管理。密钥保存在本地环境或 DeepSeek Harness 凭据库中，项目配置只保留凭据引用。

还没有配置模型时，也可以先运行本地量子示例。

npm run demo:quantum-ground-state
npm run mcp:qiskit:probe

把量子计算带进微信、飞书和更多消息平台

OpenQuantum 集成了 CC Connect。它通过标准 ACP 连接 DeepSeek Harness，让手机里的对话直接通向 OpenQuantum 已有的 Skill、MCP 和科学验收能力。

npm run cc-connect:setup
npm run cc-connect:feishu
npm run cc-connect:start

# 在另一个终端打开本地管理后台，继续管理消息平台及其凭据
npm run cc-connect:web

飞书也可以替换为微信、钉钉、企业微信、Slack、Telegram、Discord、QQ 等 CC Connect 支持的平台。第一项平台需要先按上游方式完成配置，服务才会启动。消息平台的 Token 只保存在被 Git 忽略的 CC Connect 本地配置中。详细说明见消息渠道接入。

也可以使用 Docker。

cp .env.example .env
docker compose up --build

更完整的启动方式见部署与启动。模型、MCP、凭据或 Harness 遇到问题时，可以从故障排查快速找到对应入口。

把你的量子能力接进来

OpenQuantum 沿用 DeepSeek Harness 的原生扩展方式。Skill、MCP 和 Validator 各自解决一类清楚的问题，也可以组合成一项完整的量子能力。

Skill
告诉 Agent 什么时候使用一种方法，以及这项方法适合解决什么问题。通常从一份标准 SKILL.md 开始。 MCP
把工具、数据源、量子云和设备连接交给 Agent 调用，可以使用 stdio 或 Streamable HTTP。 Validator
独立检查单位、阈值、来源和科学一致性，为科研结果提供可复核的验收结论。

接入一个新后端，通常从 MCP 开始，再用 Skill 说明适用场景。涉及科学结论时，可以继续加入 Validator 和测试。每一层都有现成示例，开发者可以只做自己需要的部分，也可以完成一条从工具到科研验收的完整链路。

开发说明见 CONTRIBUTING.md，目录和配置权威见仓库地图，架构边界见 ARCHITECTURE_AUDIT.md，生态规划见 QUANTUM_CAPABILITY_CATALOG.md。

开发与验证命令

# 检查 Harness 组合配置
npm run harness:config

# 运行完整离线质量检查
npm run check

# 配置模型后运行真实 Agent 端到端测试
npm run e2e:quantum-harness -- --provider openquantum-public

.agents/skills/          量子 Skill 与科学资源
runtime/openquantum/     OpenQuantum 模式、MCP 和 Harness 界面扩展
src/settings/server/     设置中心的服务端配置边界
scripts/                 启动、诊断和端到端测试
tests/                   平台集成测试
docs/                    架构、路线与生态文档

更完整的文档入口见 docs/README.md。

一起建设 OpenQuantum

当前版本已经包含 Web 工作台、Harness 执行轨迹、量子 Skill 与 MCP、模型与凭据设置，以及量子基态的独立科学验收。真实硬件和付费服务由使用者按需配置与开启。

我们希望 OpenQuantum 成为一块开放的底板。量子公司可以在这里接入设备和服务，高校实验室可以沉淀自己的科研流程，算法团队和工具作者也可以把新的方法交给更多人使用。

如果你想贡献代码、Skill、MCP、Validator、文档或案例，欢迎阅读 CONTRIBUTING.md。安全问题可以按照 SECURITY.md 提供的方式私密报告。

License

DeepSeek Harness、Qiskit MCP Servers、FieldQKit、Quantum Hardware MCP 和其他第三方组件沿用各自的许可证，详细来源见 THIRD_PARTY_NOTICES.md。

openQuantum FAQ

Can I use openQuantum to analyze quantum circuits and run quantum algorithms?

Yes — openQuantum lets you start quantum tasks in natural language, analyzing circuits, querying quantum cloud backends, and running algorithms with visible step-by-step results.

Does openQuantum work inside apps I already use?

You can connect openQuantum to web apps, WeChat, and Feishu, so you can send quantum computing requests right from these platforms.

Do I need an API key or account to use openQuantum?

Some quantum cloud backends require API keys or tokens for full access, but many local and read-only features work without credentials.

How hard is it to set up openQuantum?

Setup involves pasting a small configuration snippet or URL into your app, no programming needed.

Which quantum backends can openQuantum connect to?

It supports local simulators and major quantum clouds like IBM Quantum, IonQ, and several Chinese quantum cloud providers.

Can openQuantum show me the full process and results of quantum tasks?

Yes — it keeps a complete, visible record of each step, tool call, and scientific validation in the task history.