QECTOR Claude Plugin

📖 Descripción general

QECTOR Claude Plugin es la integración oficial del entorno de ingeniería e investigación de corrección de errores cuánticos (QEC) QECTOR para Claude Code y Claude Desktop. Construido sobre qector-decoder-v3, garantiza matemáticamente $H c \equiv s \pmod 2$ en 10 familias de códigos y 5 backends MWPM/BP-OSD, asegurando una integridad de fallo cerrado para la investigación cuántica empresarial y académica.

Cero egress · Matemática estricta · Fallo cerrado El plugin se ejecuta 100% localmente y nunca transmite telemetría de simulación QEC a la nube.

Este repositorio es el complemento de plugin sin aplicación para la aplicación de escritorio QECTOR Decoder Workbench (Windows / Linux). Ambas versiones v1.0.1 del workbench son totalmente compatibles con este plugin; consulte la sección Compatibilidad con Workbench.

Related MCP server: Qwen3-Coder MCP Server

🚀 Inicio rápido

1. Clonar e instalar

git clone https://github.com/GuillaumeLessard/qector-claude-plugin.git
cd qector-claude-plugin
python -m pip install -r requirements.txt
python scripts/qector_runtime_check.py

2. Instalador gráfico de Claude Desktop (Windows)

Registra instantáneamente QECTOR como una extensión de primera clase en la Configuración de Claude Desktop:

.\scripts\install_windows_connector.cmd

(Se incluye un equivalente en PowerShell como scripts/install_windows_connector.ps1. Linux y macOS usan la extensión de Claude Desktop en .claude-desktop-extension/.)

3. Integración con el marketplace de Claude Code

claude plugin marketplace add GuillaumeLessard/qector-claude-plugin
claude plugin install qector@qector-tools

4. Opcional: configuración guiada del sistema (con aprobación de seguridad)

python scripts/qector_system_setup.py --check-only   # read-only audit, no changes
python scripts/qector_system_setup.py --confirm      # execute after user approval

📥 Descargas

Recursos de la versión v1.0.2 (en dist/, cada uno con un sidecar .sha256):

Requisitos: Python 3.9+ (probado en Python 3.12), qector-decoder-v3==1.0.0, mcp==1.26.0, numpy>=1.26,<2.3, cryptography>=48.0.1,<50. Todo fijado en requirements.txt según las restricciones de las wheels publicadas.

🧩 Ecosistema

🤖 Servidores MCP (37 herramientas)

Dos servidores locales del Model Context Protocol (MCP) por stdio se ejecutan contra el núcleo qector-decoder-v3:

Herramientas de qector-library: list_code_families, list_decoders, get_license_info, decode_syndrome, decode_single, threshold_sweep, build_code_from_matrix, compat_report

wilson_ci, wilson_table, logical_coset_score, dem_inspect, dem_collapse_parallel, code_family_info, code_export_matrices, code_logicals_inspect, code_distance_check, pymatching_compat_check, sinter_decoder_list, qiskit_plugin_check, hardware_probe, license_active_check, env_block, compat_report, workbench_probe, artifacts_sha256, artifact_metadata_check, decode_faithfulness_check, hot_path_microbench, stim_circuit_probe, sinter_task_template, workload_hash, theorem_lookup, glossary_lookup, reproduction_command_lookup, system_setup, configure_claude_desktop

💬 Comandos (13 comandos slash)

🎭 Agentes (5 personas especializadas)

🛠️ Habilidades (28 primitivas de dominio)

qector-core, qector-architecture, qector-math-foundations, qector-codes-builder, qector-bp-osd, qector-two-stage-css, qector-space-time, qector-decoders-deep-dive, qector-dem-pipeline, qector-sinter, qector-ler-methodology, qector-pymatching-compat, qector-batch-decoding, qector-orchestration, qector-reproducibility, qector-testing-strategy, qector-deployment, qector-release-engineering, qector-licensing, qector-services, qector-glossary, qector-educator, qector-researcher, qector-developer, qector-sysadmin, qector-hardware-engineer, qector-roadmap, qector-workbench

🏗️ Arquitectura

┌──────────────────────────────────────────────────────────┐
│                 QECTOR Claude Plugin v1.0.2               │
│  ┌─────────────┐  ┌──────────────┐  ┌──────────────────┐ │
│  │ 13 Commands │  │  5 Agents    │  │  28 Skills       │ │
│  └──────┬──────┘  └──────┬───────┘  └────────┬─────────┘ │
│         └────────────────┼───────────────────┘           │
│                          ▼                              │
│  ┌─────────────────────────────────────────────┐        │
│  │  qector-library MCP (8 tools)   stdio only  │        │
│  │  qector-bench   MCP (29 tools)  stdio only  │        │
│  └──────────────────────────┬──────────────────┘        │
│                             │                           │
│              ┌──────────────▼──────────────┐            │
│              │  qector-decoder-v3 1.0.0     │            │
│              │  (Rust/PyO3 engine, local)   │            │
│              └─────────────────────────────┘            │
└──────────────────────────────────────────────────────────┘

Claude Desktop Extension — un conector personalizado totalmente integrado (manifest_version: 0.3, en .claude-desktop-extension/) que muestra controles nativos de interfaz, documentación y el icono de QECTOR directamente en Claude Desktop → Configuración → Conectores.

🛡️ Directrices fundamentales de ingeniería

1. Rigor matemático — Cada decodificación de síndrome individual debe verificar $H c \equiv s \pmod 2$. Las aproximaciones se rechazan.

2. Seguridad de cero egress — Las operaciones se ejecutan 100% localmente. El plugin nunca transmite telemetría de simulación QEC a la nube, protegiendo la propiedad intelectual del hardware.

3. Diseño de fallo cerrado — Las dimensiones de matriz no coincidentes, las familias de códigos no reconocidas o las solicitudes de distancia no válidas generan inmediatamente errores deterministas en lugar de corromper silenciosamente el estado cuántico.

4. Rigor estadístico — Todos los barridos de umbral LER incluyen intervalos de puntuación binomial exactos de Wilson al 95%. Las estimaciones puntuales sin límites se rechazan.

La autoridad matemática es el manual de referencia de QECTOR Decoder v3 versión 1.0.0 (DOI: 10.5281/zenodo.21941046); el plugin está fundamentado en los 16 Teoremas, 27 Capítulos y 5 Apéndices.

🤖 Compatibilidad con Workbench

La aplicación de escritorio oficial QECTOR Decoder Workbench — tanto las versiones Windows (qector-decoder-workbench-windows, .exe portátil) como Linux (qector-decoder-workbench-linux, AppImage) v1.0.1 — es totalmente compatible con este plugin:

• Ambas versiones del workbench incluyen el mismo backend qector-decoder-v3 1.0.0 que fija este plugin (qector-decoder-v3==1.0.0) — las versiones coinciden exactamente.

• Use el servidor --mcp de 85 herramientas del workbench, los dos servidores MCP stdio de este plugin, o los tres a la vez — cada transporte es solo local con cero egress de red.

• La herramienta workbench_probe del plugin detecta un workbench en ejecución e informa su versión, número de herramientas y estado del protocolo MCP.

• Los artefactos del workbench (exportaciones, informes de benchmark, sidecars de depósito) son verificados por las herramientas artifacts_sha256 / artifact_metadata_check del plugin.

📋 Requisitos del sistema

📚 Documentación

📄 Licencia

Software propietario, de código fuente disponible. Copyright (c) 2026 Guillaume Lessard e iD01t Productions. Consulte LICENSE.md.

El backend subyacente qector-decoder-v3 tiene una licencia independiente:

• ✅ Gratis para investigación personal, académica, educativa y no comercial

• 💼 Uso comercial (I+D de empresa, SaaS, API alojada, OEM, redistribución) requiere una licencia de pago

• 🔄 Evaluación comercial de 60 días disponible, acreditable contra una licencia

🤝 Soporte y contacto