QECTOR Claude Plugin

📖 Übersicht

QECTOR Claude Plugin ist die offizielle Integration der QECTOR-Quantenfehlerkorrektur- (QEC-) Entwicklungs- und Forschungsumgebung für Claude Code und Claude Desktop. Basierend auf qector-decoder-v3 erzwingt es mathematisch $H c \equiv s \pmod 2$ über 10 Code-Familien und 5 MWPM/BP-OSD-Backends und gewährleistet so eine Fail-Closed-Integrität für unternehmerische und akademische Quantenforschung.

Zero Egress · Strikte Mathematik · Fail-Closed Das Plugin läuft zu 100 % lokal und überträgt niemals QEC-Simulationstelemetrie in die Cloud.

Dieses Repository ist der app-freie Plugin-Begleiter zur Desktop-Anwendung QECTOR Decoder Workbench (Windows / Linux). Beide Workbench-Versionen v1.0.1 sind vollständig mit diesem Plugin kompatibel – siehe Abschnitt Workbench-Kompatibilität.

Related MCP server: Qwen3-Coder MCP Server

🚀 Schnellstart

1. Klonen und installieren

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. Claude-Desktop-GUI-Installationsprogramm (Windows)

Registriert QECTOR sofort als erstklassige Erweiterung in den Claude-Desktop-Einstellungen:

.\scripts\install_windows_connector.cmd

(Ein PowerShell-Äquivalent wird als scripts/install_windows_connector.ps1 ausgeliefert. Linux und macOS verwenden die Claude-Desktop-Erweiterung in .claude-desktop-extension/.)

3. Integration in den Claude-Code-Marketplace

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

4. Optional: Geführte Systemeinrichtung (mit Sicherheitsfreigabe)

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

📥 Downloads

v1.0.2-Release-Assets (in dist/, jeweils mit einer .sha256-Begleitdatei):

Anforderungen: Python 3.9+ (getestet mit Python 3.12), qector-decoder-v3==1.0.0, mcp==1.26.0, numpy>=1.26,<2.3, cryptography>=48.0.1,<50. Alle sind in requirements.txt gegen die veröffentlichten Wheel-Einschränkungen festgelegt.

🧩 Ökosystem

🤖 MCP-Server (37 Tools)

Zwei lokale stdio-Model-Context-Protocol-Server laufen gegen den qector-decoder-v3-Kern:

qector-library-Tools: 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

💬 Befehle (13 Slash-Befehle)

🎭 Agenten (5 spezialisierte Personas)

🛠️ Skills (28 Domänen-Primitive)

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

🏗️ Architektur

┌──────────────────────────────────────────────────────────┐
│                 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-Erweiterung – ein vollständig integrierter benutzerdefinierter Connector (manifest_version: 0.3, in .claude-desktop-extension/), der native UI-Steuerelemente, Dokumentation und das QECTOR-Symbol direkt in Claude Desktop → Einstellungen → Connectors anzeigt.

🛡️ Zentrale Engineering-Richtlinien

1. Mathematische Striktheit – Jede einzelne Syndrom-Decodierung muss $H c \equiv s \pmod 2$ verifizieren. Näherungen werden abgelehnt.

2. Zero-Egress-Sicherheit – Operationen laufen zu 100 % lokal. Das Plugin überträgt niemals QEC-Simulationstelemetrie in die Cloud und schützt so proprietäre Hardware-IP.

3. Fail-Closed-Design – Nicht übereinstimmende Matrixdimensionen, unbekannte Code-Familien oder ungültige Distanzanforderungen lösen sofort deterministische Fehler aus, anstatt den Quantenzustand stillschweigend zu korrumpieren.

4. Statistische Strenge – Alle LER-Schwellenwert-Sweeps enthalten exakte Wilson-95-%-Binomial-Score-Intervalle. Punktschätzungen ohne Grenzen werden abgelehnt.

Die mathematische Autorität ist das Referenzhandbuch QECTOR Decoder v3 v1.0.0 (DOI: 10.5281/zenodo.21941046); das Plugin ist gegen alle 16 Theoreme, 27 Kapitel und 5 Anhänge abgesichert.

🤖 Workbench-Kompatibilität

Die offizielle Desktop-Anwendung QECTOR Decoder Workbench – sowohl die Windows-Version (qector-decoder-workbench-windows, portable .exe) als auch die Linux-Version (qector-decoder-workbench-linux, AppImage) v1.0.1 – ist vollständig kompatibel mit diesem Plugin:

• Beide Workbench-Versionen bündeln dasselbe qector-decoder-v3 1.0.0-Backend, das dieses Plugin festlegt (qector-decoder-v3==1.0.0) – die Versionen stimmen exakt überein.

• Verwenden Sie den --mcp-Server mit 85 Tools der Workbench, die beiden stdio-MCP-Server dieses Plugins oder alle drei gleichzeitig – jeder Transport ist rein lokal und ohne Netzwerk-Egress.

• Das workbench_probe-Tool des Plugins erkennt eine laufende Workbench und meldet deren Version, Tool-Anzahl und MCP-Protokollstatus.

• Workbench-Artefakte (Exporte, Benchmark-Berichte, Deposit-Sidecars) werden von den Tools artifacts_sha256 / artifact_metadata_check des Plugins verifiziert.

📋 Systemanforderungen

📚 Dokumentation

📄 Lizenz

Proprietäre, quellverfügbare Software. Copyright (c) 2026 Guillaume Lessard und iD01t Productions. Siehe LICENSE.md.

Das zugrunde liegende qector-decoder-v3-Backend ist separat lizenziert:

• ✅ Kostenlos für persönliche, akademische, pädagogische und nicht-kommerzielle Forschung

• 💼 Kommerzielle Nutzung (Firmen-F&E, SaaS, gehostete API, OEM, Weiterverbreitung) erfordert eine kostenpflichtige Lizenz

• 🔄 60-tägige kommerzielle Evaluierung verfügbar, anrechenbar auf eine Lizenz

🤝 Support & Kontakt