Quantum Vibecoding

Execute experimentos quânticos reais em hardware quântico real via linguagem natural. Três servidores MCP em um único pacote PyPI: Quantum Inspire Tuna-9 (qubits supercondutores), IBM Quantum e quantum RNG. Instalação em uma linha: claude mcp add qi-circuits -- uvx --from "quantum-vibecoding-mcp[qi]" qvc-qi

GitHubExperimente este MCPPatrocinado

Documentação

quantum-vibecoding-mcp

Servidores do Model Context Protocol que permitem que o Claude execute experimentos quânticos reais em hardware real por meio de linguagem natural.

Três servidores são fornecidos em um único pacote:

Comando	O que faz	Backend
`qvc-qi`	Submete circuitos cQASM 3.0, consulta jobs, busca histogramas	Quantum Inspire (Tuna-9, emulador)
`qvc-ibm`	Executa circuitos em processadores IBM Quantum	IBM Quantum (Heron, Eagle, etc.)
`qvc-qrng`	Gera números aleatórios quânticos verdadeiros	QI Tuna-9 + fallback ANU

Instalação

O caminho recomendado usa uvx — sem necessidade de instalação manual.

Claude Code (CLI / Desktop)

Adicione ao seu .mcp.json (nível de projeto) ou ~/.claude.json (global):

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

Para todos os três 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"]
    }
  }
}

Instalação manual

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

Autenticação

Backend	Como
Quantum Inspire	Execute `qi login` uma vez — abre um navegador, armazena credenciais em `~/.quantuminspire/config.json`
IBM Quantum	Defina a variável de ambiente `IBM_QUANTUM_TOKEN` (obtenha uma em quantum.ibm.com)

Hello world

Após a configuração, peça ao Claude:

Submeta um circuito de estado Bell ao emulador local da QI com 1024 disparos e mostre-me o histograma.

O Claude chama qi_run_local, e você vê {"00": ~512, "11": ~512}.

Ferramentas

qvc-qi expõe: qi_list_backends, qi_submit_circuit, qi_check_job, qi_get_results, qi_run_local.

qvc-ibm expõe: ibm_list_backends, ibm_submit_circuit, ibm_check_job, ibm_get_results.

qvc-qrng expõe: quantum_random_int, quantum_coin_flip, quantum_random_hex, quantum_dice_roll e outros.

Notas sobre hardware

Conjunto de portas nativas do Tuna-9 (Quantum Inspire): CZ, Ry, Rz, X. Passe compile_stage="routing" para permitir que o compilador da QI decomponha por você.

As sequências de bits são MSB-primeiro em toda a plataforma — o qubit 0 é o caractere mais à esquerda. Consulte o artigo Quantum Vibecoding §3.4 para as convenções e a lista de bugs silenciosos.

Desenvolvimento

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

Licença

MIT.