量子编程 MCP
给你的 AI 连上量子真机，让程序不再纸上谈兵
MCP概述
量子编程MCP
QPU设备访问任务提交真机运行任务管理SKILL搭档是我们给 AI 助手"接上量子云端手臂"的服务连接器。装上它之后，量子程序就不再只是屏幕上的代码了——它能直接连上本源量子云，帮你把任务送到真实的量子芯片上跑出来，拿到货真价实的运行结果。
注意：请尽量将本 MCP 服务与 QPanda3量子编程技能库（点击查看） 结合使用，以实现完整的量子编程体验。能力范围
通过加载 量子编程MCP，AI 能够帮助你在以下方面完成工作
| 能力域 | 具体内容 |
|---|---|
| 量子设备访问 | 实时查询本源量子云可用的 QPU 设备列表，获取芯片量子比特数量、能力参数与当前运行状态等 |
| 线路采样 | VQE、QAOA、Grover 搜索、Deutsch-Jozsa、量子傅里叶变换、量子隐形传态、GHZ 态制备等，涵盖优化、搜索、密码学等多个领域 |
| 期望值估计 | 提交量子线路与可观测量，计算量子态的期望值，支持多种可观测量格式 |
| 任务管理 | 支持一键提交量子计算任务、查看任务执行状态、获取已完成任务的计算结果以及提交的任务列表 |
| 批量操作 | 同时提交多个量子线路进行批量采样或批量期望值估计，减少提交开销，高效并行执行大规模计算任务 |
使用方式
前提条件：
配置方式：
配置文件导入
直接在客户端中导入 JSON 配置文件，完成 MCP 服务连接。
UI 界面填写
在工具的 MCP 管理界面中手动填写 MCP 信息，完成服务连接。
一键配置脚本
执行一键配置脚本，快速在工具中完成 MCP 服务配置和 SKILL 的同步安装。
注：如果你认为以上配置方式均有难度，你也可将MCP的JSON模板发送给AI，并告诉AI:帮我配置这个MCP安装方式具体操作：
打开工具的设置页面，找到 MCP 相关入口（名称因工具而异，如"MCP服务器"、"模型上下文协议"、"集成"等），添加新的 MCP 服务器，点击上方的"复制JSON配置模板"，将其粘贴进去，替换<你的API密钥>后保存即可。
打开CodeBuddy的设置页面
在设置菜单中找到 MCP 相关入口
选择 "配置 MCP"
将 JSON 内容粘贴到自动打开的
替换密钥为你的量子云API_Key
保存并点击刷新按钮，即可连接
注意：鉴于不同客户端对 MCP 的配置要求各异，粘贴时请留意该工具的特定规范。若有特殊要求，请对我们的 JSON 模板进行相应调整以适配该格式。部分工具支持远程MCP服务信息填写调用（如CLine），在这部分工具中，打开 MCP 管理界面中，填入以下信息，即可成功连接MCP服务：
它可以帮你自动完成MCP配置和SKILL安装。
| 您需要有的 | 版本要求 | 说明 |
|---|---|---|
| Python | >=3.11 | 电脑上要装有Python |
| UV | — | 一个Python包管理工具，脚本用它来自动处理依赖 |
目前支持多种 AI 编码工具：OpenCode、Claude Code、Codex、Gemini CLI、CodeBuddy、Cline等；你也可以运行下方脚本实时查询支持列表，我们会不定期更新：
uv run prepare_qpanda3_ai_kits.py list打开终端，cd 到脚本所在目录，运行下面这行命令就完成了：
uv run prepare_qpanda3_ai_kits.py prepare <工具名> -k <你的API_Key>举个例子，假设你用的是CodeBuddy，运行下方命令后，脚本会自动帮你把 MCP 服务器的连接信息写入 CodeBuddy 的配置文件，再把 QPanda3量子编程技能包安装到 CodeBuddy 的技能目录：
uv run prepare_qpanda3_ai_kits.py prepare codebuddy -k <你的API_Key>6种 AI 编码工具在命令行中对应的<工具名>如下：
| 工具名称 | 命令行参数名 |
|---|---|
| OpenCode | opencode |
| Claude Code | claude |
| Codex (OpenAI) | codex |
| Gemini CLI | gemini |
| CodeBuddy | codebuddy |
| Cline | cline |
脚本支持两种安装级别：
| 级别 | 具体内容 |
|---|---|
| 全局（默认） | uv run prepare_qpanda3_ai_kits.py prepare <工具名> -k <你的API_Key> |
| 项目级 | uv run prepare_qpanda3_ai_kits.py prepare <工具名> -k <你的API_Key> -p |
如果你不确定自己装了什么工具，或者想一次把所有已安装的工具都配置好，可以执行以下命令，不指定工具名，脚本会自动扫描你的电脑，发现装了哪些支持的 AI 工具，然后逐个帮你配置好：
uv run prepare_qpanda3_ai_kits.py prepare -k <你的API_Key>如果以后不需要了，想清理干净也很简单：
只卸载某个工具的配置：
uv run prepare_qpanda3_ai_kits.py uninstall <工具名>卸载所有工具的配置：
uv run prepare_qpanda3_ai_kits.py uninstall任何时候忘了命令怎么用，运行以下命令可以查看所有命令和参数说明：
uv run prepare_qpanda3_ai_kits.py help验证方式
大部分情况下，MCP配置完成后无需手动调用。当你在AI对话中提出类似"调用量子计算机"的相关问题时，AI将自动调用MCP服务：
AI触发示例
自动识别并调用MCP服务
在对话中键入以下问题，AI会自动调用MCP服务：
如果AI能够正确返回量子计算机后端状态、执行量子任务、查询任务状态，说明MCP已生效。
典型响应示例
AI调用MCP服务后的典型响应
以下为AI调用MCP服务查询可用量子计算机后端的典型响应示例：
| 设备名称 | 本源悟空 180-2 | 硅臻·启明 |
| 芯片 ID | WK_C180_2 | PQPUMESH8 |
| 类型 | 超导量子计算机 | 光量子计算机 |
| 在线状态 | 在线 | 在线 |
| 可用量子比特数 | 180 | 3 |
如果AI返回上述类似信息，说明MCP服务已成功连接。
打开本小源，直接对话
