QECTOR Claude Plugin

📖 개요

QECTOR Claude Plugin은 Claude Code 및 Claude Desktop용 QECTOR 양자 오류 정정(QEC) 엔지니어링 및 연구 환경의 공식 통합입니다. qector-decoder-v3를 기반으로 10개 코드 패밀리와 5개 MWPM/BP-OSD 백엔드 전반에 걸쳐 $H c \equiv s \pmod 2$를 수학적으로 강제하여, 기업 및 학계 양자 연구를 위한 fail-closed 무결성을 보장합니다.

Zero Egress · 엄격한 수학 · Fail-Closed 이 플러그인은 100% 로컬에서 실행되며 QEC 시뮬레이션 원격 측정 데이터를 클라우드로 전송하지 않습니다.

이 저장소는 QECTOR Decoder Workbench 데스크톱 애플리케이션(Windows / Linux)의 앱 없는 플러그인 동반자입니다. 두 v1.0.1 워크벤치 릴리스 모두 이 플러그인과 완전히 호환됩니다 — 워크벤치 호환성 섹션을 참조하세요.

Related MCP server: Qwen3-Coder MCP Server

🚀 빠른 시작

1. 클론 및 설치

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 설치 프로그램 (Windows)

QECTOR를 Claude Desktop 설정 내 일급 Extension으로 즉시 등록합니다:

.\scripts\install_windows_connector.cmd

(PowerShell 버전은 scripts/install_windows_connector.ps1로 제공됩니다. Linux 및 macOS는 .claude-desktop-extension/의 Claude Desktop 확장을 사용합니다.)

3. Claude Code 마켓플레이스 통합

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

4. 선택 사항: 안내형 시스템 설정 (안전 승인 포함)

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

📥 다운로드

v1.0.2 릴리스 자산 (dist/ 내, 각각 .sha256 사이드카 포함):

요구 사항: Python 3.9+ (Python 3.12에서 테스트됨), qector-decoder-v3==1.0.0, mcp==1.26.0, numpy>=1.26,<2.3, cryptography>=48.0.1,<50. 모든 항목은 requirements.txt에 게시된 휠 제약 조건에 맞춰 고정되어 있습니다.

🧩 생태계

🤖 MCP 서버 (도구 37개)

두 개의 로컬 stdio Model Context Protocol 서버가 qector-decoder-v3 코어에 대해 실행됩니다:

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

💬 명령어 (슬래시 명령어 13개)

🎭 에이전트 (전문 페르소나 5개)

🛠️ 스킬 (도메인 프리미티브 28개)

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

🏗️ 아키텍처

┌──────────────────────────────────────────────────────────┐
│                 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 확장 — 완전히 통합된 커스텀 커넥터 (manifest_version: 0.3, .claude-desktop-extension/ 내)로, 네이티브 UI 컨트롤, 문서 및 QECTOR 아이콘을 Claude Desktop → 설정 → 커넥터에 직접 표시합니다.

🛡️ 핵심 엔지니어링 지침

1. 수학적 엄격성 — 모든 단일 신드롬 디코딩은 $H c \equiv s \pmod 2$를 검증해야 합니다. 근사치는 거부됩니다.

2. Zero-Egress 보안 — 모든 작업은 100% 로컬에서 실행됩니다. 플러그인은 QEC 시뮬레이션 원격 측정 데이터를 클라우드로 전송하지 않아 독점 하드웨어 IP를 보호합니다.

3. Fail-Closed 설계 — 행렬 차원 불일치, 인식되지 않은 코드 패밀리 또는 잘못된 거리 요청은 양자 상태를 조용히 손상시키는 대신 결정적 오류를 즉시 발생시킵니다.

4. 통계적 엄격성 — 모든 LER 임계값 스윕에는 정확한 Wilson 95% 이항 점수 구간이 포함됩니다. 경계가 없는 점 추정치는 거부됩니다.

수학적 권위는 QECTOR Decoder v3 참조 매뉴얼 v1.0.0 (DOI: 10.5281/zenodo.21941046)입니다. 플러그인은 16개 정리, 27개 장 및 5개 부록 전체에 근거합니다.

🤖 워크벤치 호환성

공식 QECTOR Decoder Workbench 데스크톱 애플리케이션 — Windows (qector-decoder-workbench-windows, 휴대용 .exe) 및 Linux (qector-decoder-workbench-linux, AppImage) v1.0.1 릴리스 모두 — 이 플러그인과 완전히 호환됩니다:

• 두 워크벤치 릴리스 모두 이 플러그인이 고정하는 것과 동일한 qector-decoder-v3 1.0.0 백엔드를 번들합니다 (qector-decoder-v3==1.0.0) — 버전이 정확히 일치합니다.

• 워크벤치의 85개 도구 --mcp 서버, 이 플러그인의 두 stdio MCP 서버, 또는 세 가지를 모두 동시에 사용하세요 — 모든 전송은 네트워크 이그레스가 없는 로컬 전용입니다.

• 플러그인의 workbench_probe 도구는 실행 중인 워크벤치를 감지하여 버전, 도구 수 및 MCP 프로토콜 상태를 보고합니다.

• 워크벤치 아티팩트(내보내기, 벤치마크 보고서, 예치 사이드카)는 플러그인의 artifacts_sha256 / artifact_metadata_check 도구로 검증됩니다.

📋 시스템 요구 사항

📚 문서

📄 라이선스

사유(Proprietary) 소스 공개(source-available) 소프트웨어입니다. Copyright (c) 2026 Guillaume Lessard 및 iD01t Productions. LICENSE.md를 참조하세요.

기반이 되는 qector-decoder-v3 백엔드는 별도로 라이선스가 부여됩니다:

• ✅ 개인, 학술, 교육 및 비상업적 연구 목적에는 무료

• 💼 상업적 사용(기업 R&D, SaaS, 호스팅 API, OEM, 재배포)에는 유료 라이선스가 필요합니다

• 🔄 60일 상업용 평가판이 제공되며, 라이선스 구매 비용에 상계할 수 있습니다

🤝 지원 및 문의