convez.ai
MCP ServerIntegração & APIsAvançado
markusvankempen

Quantum OpenQASM Assistant

markusvankempen/quantum-openqasm-assistant

Execute circuitos quânticos OpenQASM direto do seu IDE

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server e extensão VS Code para submeter circuitos OpenQASM 2.0 ao hardware quântico real da IBM Quantum. Inclui editor interativo, polling de jobs, histogramas e suporte para Cursor, VS Code e assistentes de IA com integração SamplerV2.

Instalação

$npx convez-ai markusvankempen/quantum-openqasm-assistant

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
71%
Último commit
há 4 meses
Versão
v1.8.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Prototipagem de algoritmos quânticos em VS Code
  • Submissão de circuitos para execução em hardware quântico IBM
  • Integração de computação quântica em fluxos de IA com MCP

Veredito

Ferramenta especializada e bem arquitetada para computação quântica, conectando IDEs modernos à infraestrutura IBM Quantum. Excelente para pesquisadores e desenvolvedores quânticos usando Claude/Cursor, porém com nicho técnico bastante específico.

README

A tradução para o português deste README ainda está na fila.

Quantum OpenQASM Assistant

VS Code Extension OpenQASM MCP IBM Quantum License

Quantum OpenQASM Assistant is a VS Code extension and Model Context Protocol (MCP) server for IBM Quantum — submit OpenQASM 2.0 circuits to real quantum hardware and simulators from Cursor, VS Code, IBM Bob, and Google Antigravity. Includes Quantum Lab (interactive circuit editor), live job polling, measurement histograms, Bell state / GHZ examples, SamplerV2 REST integration, and one-click MCP setup for AI coding assistants.

Search terms: quantum computing · openqasm · qasm · ibm quantum · qiskit · quantum circuit · quantum hardware · mcp server · model context protocol · cursor mcp · vscode quantum · ai quantum assistant · quantum programming · qubit · bell state

Author: Markus van Kempen
Email: markus.van.kempen@gmail.com · mvk@ca.ibm.com
Website: markusvankempen.github.io
No bug too small, no syntax too weird.


Overview

Quantum OpenQASM Assistant connects AI agents and developers to IBM Quantum through a pure TypeScript MCP server and VS Code extension. Submit OpenQASM 2.0 ISA circuits, poll job status, and view measurement histograms — locally via stdio or remotely via SSE on IBM Code Engine.

ProductIdentifier
VS Code Extensionmarkusvankempen.quantum-openqasm-assistant
NPM MCP Server@markusvankempen/quantum-openqasm-mcp
Public repoquantum-openqasm-assistant
graph TB
    subgraph clients [MCP Clients]
        Cursor[Cursor / VS Code]
        Bob[IBM Bob]
        AG[Antigravity]
        Lab[Quantum Lab Extension]
    end

    subgraph mcp [MCP Server]
        Local["server.ts stdio"]
        Remote["server-sse.ts SSE"]
    end

    IBM["IBM Quantum REST API<br/>SamplerV2 · OpenQASM 2.0"]

    Cursor -->|stdio| Local
    Bob -->|stdio| Local
    AG -->|stdio| Local
    Lab -->|stdio or SSE| Local
    Lab -->|SSE| Remote
    Local --> IBM
    Remote --> IBM
sequenceDiagram
    participant User
    participant Ext as VS Code Extension
    participant MCP as MCP Server
    participant IBM as IBM Quantum API

    User->>Ext: Submit .qasm circuit
    Ext->>MCP: submit_qasm_job
    MCP->>IBM: POST /jobs (SamplerV2)
    IBM-->>MCP: job id
    MCP-->>Ext: job id
    loop Poll every 15s
        Ext->>MCP: get_job_status
        MCP->>IBM: GET /jobs/{id}
        IBM-->>Ext: Queued → Running → Completed
    end
    Ext->>MCP: get_job_results
    MCP->>IBM: GET /jobs/{id}/results
    IBM-->>Ext: measurement histogram

📖 Documentation hub → docs/README.md · Project structure → docs/PROJECT-STRUCTURE.md · OpenQASM Primer → docs/OPENQASM-PRIMER.md · Tips & Tricks → docs/TIPS-AND-TRICKS.md · Architecture → docs/ARCHITECTURE.md · Local MCP setup → docs/ide/LOCAL-MCP-SETUP.md · Deployment → docs/deployments/DEPLOYMENT-SCENARIOS.md · Extension → extension/README.md · Contributing → CONTRIBUTING.md

Repository policy: This public GitHub repo publishes overview and setup documentation. Extension source code, scripts, and examples live in the private dev repo (use .gitignore.private when setting it up).


Features

FeatureDescription
Quantum LabInteractive panel with example circuits and histogram results
OpenQASM 2.0IBM hardware ISA format (rz, sx, cz native gates)
MCP toolslist_backends, submit_qasm_job, get_job_status, get_job_results, and more
Multi-IDE MCPOne-click setup for Cursor, VS Code, Bob & Antigravity
Local / remotestdio MCP locally or SSE via IBM Code Engine
DiagnosticsTest IAM auth, list backends, save credentials from the UI

MCP tools

ToolDescription
list_backendsAvailable IBM Quantum backends, status, queue
get_backendDetails for a specific backend
submit_qasm_jobSubmit OpenQASM 2.0 circuit
get_job_statusPoll job state
get_job_resultsMeasurement counts / histogram data
cancel_jobCancel a running job

Quick start

Prerequisites

Build (private dev repo)

mise run install
mise run build

Configure

cp .env.example .env
# IBM_API_KEY, IBM_SERVICE_CRN, IBM_QUANTUM_ENDPOINT, IBM_QUANTUM_BACKEND

Or use Quantum → Settings & Diagnostics in the extension.

Test

mise run test-e2e
# or: Press F5 in VS Code → Quantum Lab → Run on Hardware

Install extension

mise run package
code --install-extension extension/quantum-openqasm-assistant-*.vsix

Architecture at a glance

quantum-openqasm-assistant/
├── extension/              # VS Code extension + bundled MCP server
│   ├── src/extension.ts    # Extension entry, MCP client
│   ├── src/server.ts       # Local stdio MCP server
│   ├── src/server-sse.ts   # Remote SSE MCP server
│   └── out/                # esbuild output
├── packages/
│   └── quantum-openqasm-mcp/   # Standalone npm MCP package
├── scripts/                # MCP launcher, e2e tests, examples
├── docs/                   # Published documentation
│   └── QISKIT-INTEGRATION.md  # Qiskit → OpenQASM → IBM Quantum
├── examples/               # Qiskit export script (public)
├── deployments/            # Client modes + infrastructure
│   ├── README.md           # Hub: 5 client modes + 6 infra scenarios
│   ├── extension-only/     # Mode 1
│   ├── extension-mcp-local/# Mode 2
│   ├── mcp-npm/            # Mode 3
│   ├── extension-remote-mcp/# Mode 4
│   ├── mcp-remote-sse/     # Mode 5
│   ├── code-engine/        # IBM Code Engine
│   ├── local-bridge/       # Dev gateway
│   ├── docker-sse/         # Self-hosted
│   ├── secured-remote/     # Auth tiers
│   ├── wxo-orchestrate/    # Orchestrate agents
│   └── ci-cd/              # Pipeline smoke tests
└── Internal/               # Branding, publishing, status (gitignored)

See docs/PROJECT-STRUCTURE.md for the complete file map.


Documentation

GuideDescription
Documentation hubIndex of all published guides
ArchitectureSystem design, MCP, IBM API flow
OpenQASM PrimerLearn OpenQASM 2.0 in plain English
Qiskit integrationQiskit → export QASM → IBM hardware via MCP / Lab
Tips & TricksBackend selection, MCP workflows
Project structureComplete repo layout
Extension READMEVS Code extension features, commands
Local MCP setupCursor, VS Code, Bob, Antigravity
Deployment hub5 client modes + infra (CE, Docker, WxO, CI)
Deployment scenariosLocal, Code Engine, Docker, hybrid

Security

  • API keys live in VS Code settings or ~/.quantum-openqasm-mcp/.env — never in git
  • .env, Internal/, and IDE mcp.json files are gitignored
  • Report issues via GitHub Issues

Contributing

Contributions welcome! See CONTRIBUTING.md for the two-repo model, mise tasks, and PR process.

Please read our CODE_OF_CONDUCT.md.


License

Apache License 2.0


Topics & keywords

quantum-computing · quantum-computer · openqasm · openqasm-2 · qasm · ibm-quantum · ibm-cloud · qiskit · quantum-circuit · quantum-hardware · quantum-lab · quantum-programming · quantum-physics · qubit · bell-state · quantum-job · quantum-backend · mcp · model-context-protocol · mcp-server · vscode-extension · cursor · ibm-bob · antigravity · copilot · ai-assistant · typescript · nodejs · histogram · sampler-v2 · code-engine · cloud-quantum


Author: Markus van Kempen
Email: markus.van.kempen@gmail.com · mvk@ca.ibm.com
Website: markusvankempen.github.io
No bug too small, no syntax too weird.

Ver o original no GitHub

Bom para

Relacionados