de en es ja ko ru zh

QPanda3 Runtime MCP Server

Name: QPanda3 Runtime MCP Server
Author: OriginQ

by OriginQ

Overview Schema Related Servers Score Discussions

Python

Remote

MCP-сервер QPanda3 Runtime

Python 3.10+ FastMCP License Documentation

Сервер протокола контекста модели (MCP), который позволяет ИИ-ассистентам взаимодействовать с облачными квантовыми вычислениями Origin Quantum через QPanda3 Runtime.

Возможности

Управление учетными записями: Настройка и управление аутентификацией в облаке Origin Quantum
Управление устройствами: Просмотр списка и запрос доступных квантовых процессоров (QPU)
Задачи квантовых вычислений: Выполнение задач сэмплирования и оценки
Пакетные операции: Эффективный запуск нескольких схем
Многокритериальные решения: CircuitObservableBinding для сложной оптимизации
Управление задачами: Запрос статуса задачи, получение результатов, отмена задач
Примеры схем: Предоставляет ресурсы с примерами распространенных квантовых схем

Документация

Документ	Описание
English Docs	Документация на английском языке
中文文档	Документация на китайском языке
Getting Started	Полное руководство для начинающих — НАЧНИТЕ ОТСЮДА
Installation Guide	Подробные инструкции по установке
Quick Start	Быстрая настройка для опытных пользователей
Configuration	Настройка среды и клиента
User Guide	Подробная документация по функциям
API Reference	Автоматически сгенерированная документация API

Установка

Установка в один клик (рекомендуется)

Проект предоставляет скрипты установки, которые автоматизируют весь процесс:

Linux / macOS:

git clone https://github.com/OriginQ/qpanda3-runtime-mcp-server.git
cd qpanda3-runtime-mcp-server
chmod +x scripts/setup_configure.sh
./scripts/setup_configure.sh

Windows (PowerShell):

git clone https://github.com/OriginQ/qpanda3-runtime-mcp-server.git
cd qpanda3-runtime-mcp-server
.\scripts\setup_configure.ps1

Скрипт выполняет все действия: настройку зависимостей, конфигурацию ключа API и настройку MCP-клиента.

См. Руководство по установке для вариантов ручной установки.

Быстрый старт

# 1. Configure your API key
cp .env.example .env
# Edit .env and set QPANDA3_API_KEY=your_api_key_here

# 2. Run the server
.venv/bin/python -m qpanda3_runtime_mcp_server       # Linux/macOS
# .venv\Scripts\python.exe -m qpanda3_runtime_mcp_server  # Windows

См. Конфигурацию для настройки MCP-клиента и расширенных параметров.

Инструменты MCP

Управление учетными записями

Инструмент	Описание
`setup_origin_quantum_account_tool`	Настройка аутентификации в облаке Origin Quantum
`list_saved_accounts_tool`	Список сохраненных учетных записей (на основе сессии)
`active_account_info_tool`	Получение информации об активной учетной записи

Управление устройствами

Инструмент	Описание
`list_qpu_devices_tool`	Список всех доступных квантовых процессоров (QPU)
`get_qpu_properties_tool`	Получение подробных свойств конкретного QPU

Задачи квантовых вычислений

Инструмент	Описание
`sample_tool`	Выполнение задачи сэмплирования квантовой схемы на QPU
`estimate_tool`	Выполнение задачи оценки математического ожидания для квантовой схемы
`batch_sample_tool`	Пакетное выполнение нескольких задач сэмплирования квантовых схем
`batch_estimate_tool`	Пакетное выполнение задач оценки для нескольких схем с одним наблюдаемым

Многокритериальные решения (CircuitObservableBinding)

Инструмент	Описание
`create_circuit_observable_binding_tool`	Создание привязки для нескольких схем и наблюдаемых
`add_product_rule_tool`	Добавление правила декартова произведения (все комбинации)
`add_zip_rule_tool`	Добавление правила попарного объединения
`estimate_with_binding_tool`	Выполнение оценки с использованием созданной привязки
`list_bindings_tool`	Список всех сохраненных объектов CircuitObservableBinding
`delete_binding_tool`	Удаление сохраненного объекта CircuitObservableBinding

Управление задачами

Инструмент	Описание
`get_task_status_tool`	Получение статуса выполнения задачи (`PENDING`/`RUNNING`/`DONE`/`FAILED`/`CANCELLED`)
`get_task_results_tool`	Получение результатов вычислений завершенной задачи
`cancel_task_tool`	Отмена запущенной или ожидающей задачи
`list_my_tasks_tool`	Список недавних задач квантовых вычислений пользователя

Ресурсы MCP

URI ресурса	Описание
`qpanda://status`	Статус сервиса
`circuits://bell-state`	Пример схемы состояния Белла
`circuits://ghz-state`	Пример схемы состояния GHZ
`circuits://random`	Схема генератора случайных чисел
`circuits://superposition`	Пример схемы суперпозиции

Пример использования

Настройка учетной записи

# Auto-configure via environment variables
# Or call explicitly
await setup_origin_quantum_account_tool(
    api_key="your_api_key"
)

Список устройств

devices = await list_qpu_devices_tool()
print(f"Available devices: {devices['total_devices']}")

Выполнение задачи сэмплирования

# Bell state circuit
circuit = """QINIT 2
CREG 2
H q[0]
CNOT q[0],q[1]
MEASURE q[0],c[0]
MEASURE q[1],c[1]"""

result = await sample_tool(
    circuit=circuit,
    device_id="20",
    shots=1000
)
task_id = result["task_id"]

# Check status and get results
status = await get_task_status_tool(task_id)
if status["task_status"] == "DONE":
    results = await get_task_results_tool(task_id)
    print(f"Measurement results: {results['results']}")

Настройка в платформах разработки с ИИ

Автоматическая настройка: Используйте ./scripts/setup_configure.sh --mcp claude-desktop (или --mcp cline, --mcp cursor и т.д.)

Все клиенты используют одинаковый формат конфигурации (замените /path/to/... на ваш реальный путь):

{
  "mcpServers": {
    "qpanda3-runtime": {
      "command": "/path/to/qpanda3-runtime-mcp-server/.venv/bin/python",
      "args": ["-m", "qpanda3_runtime_mcp_server"],
      "cwd": "/path/to/qpanda3-runtime-mcp-server",
      "env": { "QPANDA3_API_KEY": "your_api_key_here" }
    }
  }
}

Клиент	Расположение файла конфигурации
Claude Code	`~/.claude.json`
Claude Desktop	macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
Cline	`~/.vscode-server/data/User/globalStorage/saoudrizwan.cline/settings/cline_mcp_settings.json`
Cursor	`.cursor/mcp.json` (корень проекта)
Windsurf	`~/.codeium/windsurf/mcp_config.json`

Для других клиентов (Trae и т.д.) см. Руководство по конфигурации.

Разработка

Установка зависимостей для разработки

uv sync --extra dev --extra test

Запуск тестов

uv run pytest

Линтинг кода

uv run ruff check .
uv run mypy src/

Сборка документации

# Install documentation dependencies
uv sync --extra docs

# Build documentation (English + Chinese)
./scripts/build-docs.sh

# Local preview with live reload (language switching supported)
mkdocs serve

Структура проекта

qpanda3-runtime-mcp-server/
├── src/
│   └── qpanda3_runtime_mcp_server/
│       ├── __init__.py          # Package entry point
│       ├── server.py            # MCP server definition
│       ├── runtime.py           # QPanda3 Runtime core logic
│       └── utils.py             # Utility functions
├── scripts/
│   ├── setup_configure.sh       # One-click setup (Linux/macOS)
│   ├── setup_configure.ps1      # One-click setup (Windows PowerShell)
│   ├── setup_configure.bat      # One-click setup (Windows CMD)
│   ├── build-docs.sh            # Build all documentation
│   └── serve-docs.sh            # Serve docs with live reload
├── tests/
│   ├── __init__.py
│   ├── conftest.py              # pytest configuration
│   ├── test_server.py           # Server tests
│   └── test_runtime.py          # Runtime tests
├── docs/
│   ├── *.md                     # English documentation (default)
│   └── cn/                      # Chinese documentation
├── mkdocs.yml                   # MkDocs configuration (i18n)
├── .github/
│   └── workflows/               # GitHub Actions workflows
├── pyproject.toml               # Project configuration
├── README.md                    # Project documentation
├── LICENSE                      # Apache 2.0 License
├── .env.example                 # Environment variable example
└── .gitignore                   # Git ignore file

Примечания

Сервер по умолчанию: Сервер по умолчанию подключается к https://qpanda3-runtime.qpanda.cn. Установите QPANDA3_SERVER_URL для переопределения.
Канал: Сервер по умолчанию использует канал qcloud.
Поддержка асинхронности: Все функции инструментов являются async функциями.
Обработка ошибок: Все функции возвращают словари, содержащие поле status.
Подсказки типов: Для лучшей читаемости кода используются подсказки типов Python.

Лицензия

Этот проект лицензирован по лицензии Apache License 2.0 — подробности см. в файле LICENSE.

Полезные ссылки

Участие в разработке

Подробности см. в Руководстве по участию.

Журнал изменений

Историю версий см. в Журнале изменений.

Install Server

security – no known vulnerabilities

license - permissive license

quality - A tier

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security
Open Source Has a Bot Problem
By punkpeye on March 19, 2026.
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/OriginQ/qpanda3-runtime-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server