QECTOR Claude Plugin

📖 概要

QECTOR Claude プラグインは、Claude Code および Claude Desktop 向けの QECTOR 量子誤り訂正（QEC）エンジニアリング・研究環境の公式統合です。qector-decoder-v3 を基盤とし、10 の符号ファミリーと 5 つの MWPM/BP-OSD バックエンドにわたって $H c \equiv s \pmod 2$ を数学的に強制し、エンタープライズおよび学術の量子研究に対してフェイルクローズ型の完全性を保証します。

ゼロエグレス · 厳密な数学 · フェイルクローズ このプラグインは 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 設定内のファーストクラス拡張機能として即座に登録します:

.\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 種）

2 つのローカル 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. ゼロエグレスセキュリティ — すべての操作は 100% ローカルで実行されます。このプラグインは QEC シミュレーションテレメトリをクラウドに送信することはなく、独自のハードウェア IP を保護します。

3. フェイルクローズ設計 — 行列の次元不一致、認識されない符号ファミリー、無効な距離要求は、量子状態を静かに破壊するのではなく、直ちに決定的エラーを発生させます。

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 サーバー、このプラグインの 2 つの stdio MCP サーバー、または 3 つすべてを同時に使用できます — すべてのトランスポートは ローカルのみで、ネットワークエグレスはゼロです。

• プラグインの workbench_probe ツールは、実行中のワークベンチを検出し、 そのバージョン、ツール数、MCP プロトコルステータスを報告します。

• ワークベンチの成果物（エクスポート、ベンチマークレポート、デポジットサイドカー）は、 プラグインの artifacts_sha256 / artifact_metadata_check ツールによって検証されます。

📋 システム要件

📚 ドキュメント

📄 ライセンス

プロプライエタリなソース公開ソフトウェア。Copyright (c) 2026 Guillaume Lessard および iD01t Productions。LICENSE.md を参照してください。

基盤となる qector-decoder-v3 バックエンドは別途ライセンスされています：

• ✅ 個人、学術、教育、非営利研究には無料

• 💼 商用利用（企業のR&D、SaaS、ホステッドAPI、OEM、再配布）には有料ライセンスが必要です

• 🔄 60日間の商用評価版が利用可能で、ライセンス購入時に充当できます

🤝 サポート & お問い合わせ