Skip to main content
Glama
deenesjakoruzh
OriginQ

QPanda3 Runtime MCP Server

by OriginQ
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

Servidor MCP de tiempo de ejecución de QPanda3

Python 3.10+ FastMCP License Documentation

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los asistentes de IA interactuar con los servicios de computación cuántica de Origin Quantum a través del tiempo de ejecución de QPanda3.

Características

  • Gestión de cuentas: Configura y gestiona la autenticación de la cuenta en la nube de Origin Quantum

  • Gestión de dispositivos: Enumera y consulta los dispositivos QPU disponibles

  • Tareas de computación cuántica: Ejecuta tareas de muestreo y estimación

  • Operaciones por lotes: Ejecuta múltiples circuitos de manera eficiente

  • Decisiones multiobjetivo: CircuitObservableBinding para optimizaciones complejas

  • Gestión de tareas: Consulta el estado de las tareas, recupera resultados y cancela tareas

  • Ejemplos de circuitos: Proporciona recursos de ejemplo de circuitos cuánticos comunes

Documentación

Documento

Descripción

Documentación en inglés

Sitio de documentación en inglés

中文文档

Sitio de documentación en chino

Primeros pasos

Guía completa para principiantes - EMPIEZA AQUÍ

Guía de instalación

Instrucciones detalladas de instalación

Inicio rápido

Configuración rápida para usuarios experimentados

Configuración

Configuración del entorno y del cliente

Guía del usuario

Documentación detallada de las funciones

Referencia de API

Documentación de API generada automáticamente

Instalación

Configuración con un solo clic (Recomendado)

El proyecto proporciona scripts de configuración que automatizan todo el proceso:

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

El script se encarga de todo: configuración de dependencias, configuración de la clave API y configuración del cliente MCP.

Consulta la Guía de instalación para opciones de instalación manual.

Inicio rápido

# 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

Consulta Configuración para la configuración del cliente MCP y opciones avanzadas.

Herramientas MCP

Gestión de cuentas

Herramienta

Descripción

setup_origin_quantum_account_tool

Configura la autenticación de la cuenta en la nube de Origin Quantum

list_saved_accounts_tool

Enumera la información de las cuentas guardadas (basado en sesión)

active_account_info_tool

Obtiene la información de la cuenta activa actualmente

Gestión de dispositivos

Herramienta

Descripción

list_qpu_devices_tool

Enumera todos los dispositivos QPU (Unidad de Procesamiento Cuántico) disponibles

get_qpu_properties_tool

Obtiene propiedades detalladas de un dispositivo QPU específico

Tareas de computación cuántica

Herramienta

Descripción

sample_tool

Ejecuta una tarea de muestreo de circuito cuántico en un dispositivo QPU

estimate_tool

Ejecuta una tarea de estimación de expectativas para un circuito cuántico

batch_sample_tool

Ejecuta por lotes múltiples tareas de muestreo de circuitos cuánticos

batch_estimate_tool

Ejecuta por lotes tareas de estimación para múltiples circuitos con un observable

Decisión multiobjetivo (CircuitObservableBinding)

Herramienta

Descripción

create_circuit_observable_binding_tool

Crea un enlace para múltiples circuitos y observables

add_product_rule_tool

Añade una regla de combinación de producto cartesiano (todas las combinaciones)

add_zip_rule_tool

Añade una regla de combinación uno a uno (combinaciones emparejadas)

estimate_with_binding_tool

Ejecuta la estimación utilizando el enlace creado

list_bindings_tool

Enumera todos los objetos CircuitObservableBinding almacenados

delete_binding_tool

Elimina un objeto CircuitObservableBinding almacenado

Gestión de tareas

Herramienta

Descripción

get_task_status_tool

Obtiene el estado de ejecución de una tarea (PENDING/RUNNING/DONE/FAILED/CANCELLED)

get_task_results_tool

Obtiene los resultados de computación de una tarea completada

cancel_task_tool

Cancela una tarea en ejecución o pendiente

list_my_tasks_tool

Enumera las tareas de computación cuántica recientes del usuario

Recursos MCP

URI del recurso

Descripción

qpanda://status

Estado del servicio

circuits://bell-state

Ejemplo de circuito de estado de Bell

circuits://ghz-state

Ejemplo de circuito de estado GHZ

circuits://random

Circuito generador de números aleatorios

circuits://superposition

Ejemplo de circuito de superposición

Ejemplo de uso

Configurar cuenta

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

Listar dispositivos

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

Ejecutar tarea de muestreo

# 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']}")

Configuración en plataformas de codificación de IA

Configuración automática: Usa ./scripts/setup_configure.sh --mcp claude-desktop (o --mcp cline, --mcp cursor, etc.)

Todos los clientes utilizan el mismo formato de configuración (reemplaza /path/to/... con tu ruta real):

{
  "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" }
    }
  }
}

Cliente

Ubicación del archivo de configuración

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 (raíz del proyecto)

Windsurf

~/.codeium/windsurf/mcp_config.json

Para más clientes (Trae, etc.), consulta la Guía de configuración.

Desarrollo

Instalar dependencias de desarrollo

uv sync --extra dev --extra test

Ejecutar pruebas

uv run pytest

Linting de código

uv run ruff check .
uv run mypy src/

Construir documentación

# 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

Estructura del proyecto

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

Notas

  1. Servidor predeterminado: El servidor se conecta a https://qpanda3-runtime.qpanda.cn de forma predeterminada. Establece QPANDA3_SERVER_URL para anularlo.

  2. Canal: El servidor utiliza el canal qcloud de forma predeterminada

  3. Soporte asíncrono: Todas las funciones de herramientas son funciones async

  4. Manejo de errores: Todas las funciones devuelven diccionarios que contienen un campo status

  5. Sugerencias de tipo: Se utilizan sugerencias de tipo de Python para una mejor legibilidad del código

Licencia

Este proyecto tiene licencia Apache 2.0; consulta el archivo LICENSE para obtener más detalles.

Enlaces relacionados

Contribución

Consulta la Guía de contribución para obtener más detalles.

Registro de cambios

Consulta el Registro de cambios para ver el historial de versiones.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - A tier

How are these scores calculated?

Resources

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

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