Quantum Vibecoding

Ejecuta experimentos cuánticos reales en hardware cuántico real mediante lenguaje natural. Tres servidores MCP en un solo paquete PyPI: Quantum Inspire Tuna-9 (qubits superconductores), IBM Quantum y RNG cuántico. Instalación en una línea: claude mcp add qi-circuits -- uvx --from "quantum-vibecoding-mcp[qi]" qvc-qi

GitHubPrueba este MCPPatrocinado

Documentación

quantum-vibecoding-mcp

Servidores del Model Context Protocol que permiten a Claude ejecutar experimentos cuánticos reales en hardware real mediante lenguaje natural.

Tres servidores se incluyen en un solo paquete:

Comando	Qué hace	Backend
`qvc-qi`	Envía circuitos cQASM 3.0, consulta trabajos, obtiene histogramas	Quantum Inspire (Tuna-9, emulador)
`qvc-ibm`	Ejecuta circuitos en procesadores IBM Quantum	IBM Quantum (Heron, Eagle, etc.)
`qvc-qrng`	Genera números aleatorios cuánticos reales	QI Tuna-9 + respaldo ANU

Instalación

La ruta recomendada utiliza uvx — no se necesita instalación manual.

Claude Code (CLI / Escritorio)

Agrega a tu .mcp.json (a nivel de proyecto) o ~/.claude.json (global):

{
  "mcpServers": {
    "qi-circuits": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "quantum-vibecoding-mcp[qi]", "qvc-qi"]
    }
  }
}

Para los tres servidores:

{
  "mcpServers": {
    "qi-circuits": {
      "command": "uvx",
      "args": ["--from", "quantum-vibecoding-mcp[qi]", "qvc-qi"]
    },
    "ibm-quantum": {
      "command": "uvx",
      "args": ["--from", "quantum-vibecoding-mcp[ibm]", "qvc-ibm"]
    },
    "qrng": {
      "command": "uvx",
      "args": ["--from", "quantum-vibecoding-mcp[qi]", "qvc-qrng"]
    }
  }
}

Instalación manual

pip install "quantum-vibecoding-mcp[all]"
qvc-qi   # then point claude at this binary

Autenticación

Backend	Cómo
Quantum Inspire	Ejecuta `qi login` una vez — abre un navegador, guarda las credenciales en `~/.quantuminspire/config.json`
IBM Quantum	Configura la variable de entorno `IBM_QUANTUM_TOKEN` (obtén una en quantum.ibm.com)

Hola mundo

Después de la configuración, pídele a Claude:

Envía un circuito de estado Bell al emulador local de QI con 1024 disparos y muéstrame el histograma.

Claude llama a qi_run_local, y verás {"00": ~512, "11": ~512}.

Herramientas

qvc-qi expone: qi_list_backends, qi_submit_circuit, qi_check_job, qi_get_results, qi_run_local.

qvc-ibm expone: ibm_list_backends, ibm_submit_circuit, ibm_check_job, ibm_get_results.

qvc-qrng expone: quantum_random_int, quantum_coin_flip, quantum_random_hex, quantum_dice_roll, y otros.

Notas sobre hardware

Conjunto de puertas nativas de Tuna-9 (Quantum Inspire): CZ, Ry, Rz, X. Pasa compile_stage="routing" para que el compilador de QI descomponga por ti.

Las cadenas de bits usan MSB primero en todos los casos — el qubit 0 es el carácter más a la izquierda. Consulta el artículo de Quantum Vibecoding §3.4 para las convenciones y la lista de errores silenciosos.

Desarrollo

git clone https://github.com/JDerekLomas/quantuminspire.git
cd quantuminspire/mcp-servers
pip install -e ".[all]"

Licencia

MIT.