QECTOR Quantum Error Correction

QECTOR Claude Plugin

Claude 向けの検証済み量子誤り訂正です。ローカルで決定論的に動作し、作業するすべてのマシンで数学的に保証されます。

QECTOR は、公開済みの qector-decoder-v3==1.0.0 エンジンを Claude Code および Claude Desktop と統合し、どちらも本番品質の QEC エンジニアリング環境に変えます。MCP サーバーが返すすべての訂正は、プロセスを離れる前にパリティ関係 H c = s (mod 2) に照らして検証され、すべての主張には機械検証可能な来歴クラスが付与されます。また、デフォルト設定では、いかなる種類のネットワークリクエストも行いません。

MCP サーバー 4 台 · 安定版ツール 8 個／研究用ツール 29 個／管理用ツール 3 個 · コマンド 11 個 · エージェント 5 個 · スキル 28 個 · デフォルトでは外部通信ゼロ

最新リリース — v1.0.6 · Claude.ai マーケットプレイスへの準拠（ランチャーを scripts/ に配置、標準マニフェスト）、 環境を問わない /qec-setup、決定論的なアーティファクト。詳しくは リリース告知をご覧ください。

---

v1.0.6 の理由

バージョン 1.0.6 では、1.0.5 で始まった移植性と準拠対応を完成させ、マーケットプレイスへの適合性と汎用的なセットアップを加えました。背景には 2 つの問題がありました。最新のオペレーティングシステムでは、予測可能なコマンド名で Python が提供されなくなっています（macOS、Debian、Ubuntu、Fedora では python ではなく python3 が提供され、Windows には独自の解決処理の癖があります）。また、claude.ai のマーケットプレイス承認パイプラインは、bin/ に実行可能ファイルを含むプラグインを拒否します。このリリースでは、両方の問題を恒久的に解消します。

1. 汎用かつ準拠したランチャーを、すべてのアーティファクトに同梱します。

• プラグインアーカイブ、ソースディストリビューション、Desktop バンドルのすべてに、scripts/qector-python（POSIX sh）と scripts/qector-python.cmd（Windows）が含まれます。これらは bin/ ではなく scripts/ に配置されます。claude.ai ホストのプラグインでは、管理者の承認画面に表示されないまま PATH に追加されるため、bin/ の実行可能ファイルを同梱できません。今後、ビルドで bin/ が再導入されると、バリデーターがエラーとして処理します。
• 推測ではなく、定められた順序で解決します。管理者が指定したインタープリターを最優先し、次に python3、その後に python を使用します。Windows では、それらすべてより先に py ランチャーを試します。
• サポート対象のバージョン範囲を文書に記すだけでなく、実際に強制します。公開済みのネイティブホイールの対応範囲に合わせて、Python 3.9 から 3.13 のみを実行します。範囲外のマシンでは、深い階層でインポートエラーが発生する代わりに、適切な対処方法を明確に案内します。
• どちらの環境でも、インタープリターの指定を正式にサポートします。QECTOR_PYTHON にインタープリターの絶対パスを設定すると、すべてのランチャーで自動検出より優先されます。

2. マーケットプレイス向けの設定を標準形式に統一します。

plugin.json と marketplace.json はどちらも、文書化されたフィールドのみを使用し、同一リポジトリ内のプラグインを相対パスで指定します。これはすべての公式マーケットプレイスで使用される形式であり、すべての同期経路で解決できる唯一の形式です。Desktop MCPB には win32 プラットフォームのオーバーライドが含まれ、Windows では必ず .cmd ランチャーが選択されます。

3. どの環境でもセットアップできます。

/qec-setup は、サンドボックス環境とリモート環境（claude.ai のコード実行、Cowork、プロジェクトのチェックアウトがないコンテナー）を検出し、ローカルスクリプトが見つからず処理が停止する代わりに、ネイティブの診断に切り替えます。また、どの経路を使用したかを正確に報告します。

プラットフォームのサポート

環境	インストール方法	状態
Claude Code CLI	ローカル stdio 経由のマーケットプレイスプラグイン	✅ Windows、macOS、Linux
Claude Desktop	ワンクリックでインストールできる .mcpb バンドル	✅ Windows、macOS
Web、iOS、Android、Cowork	ホスト型リモートコネクター（OAuth 対応 Streamable HTTP）	🗺️ ロードマップ 1.1.x
エアギャップ環境および制限された IT 環境	ローカル stdio、完全オフラインがデフォルト	✅

アーキテクチャ上、ローカル stdio から Web やモバイルには接続できません。ホスト型コネクターは、これらの環境に対応するために設計された経路であり、1.1.x で提供されます。

インストール

前提条件

要件	確認方法	推奨値
Python 3.9–3.13	python --version and py -3 --version (Windows)	3.11.x or 3.12.x recommended; 3.14+ is rejected on purpose
pip	python -m pip --version	any recent
Claude Code ≥2.0 or Claude Desktop ≥0.10.0	claude --version	2.1.x / 1.34+

パスにスペースを含む Python（例：Anthropic Skills and agents）にも対応しました。v1.0.6 の Desktop 拡張機能は python を直接使用し（${__dirname} ランチャーは使用しません）、Code プラグインは scripts/qector-python を使用します。それでも Server disconnected と表示される場合は、QECTOR_PYTHON を設定してください（トラブルシューティングを参照）。

オプション A — Claude Code（マーケットプレイス、30 秒）

# 1. Add the marketplace (once)
claude plugin marketplace add GuillaumeLessard/qector-claude-plugin

# 2. Install the plugin
claude plugin install qector@qector-tools
# When prompted for Python interpreter: leave empty for auto-resolve,
# or paste an absolute path like C:\Program Files\Python311\python.exe

# 3. Verify
claude plugin list                          # → qector@qector-tools 1.0.6 enabled
claude plugin validate . --strict           # → ✔ Validation passed
python scripts/qector_runtime_check.py      # → status: ok, mcp 1.29.0

オプション B — Claude Desktop（ワンクリック）

UI から（推奨）：

1. リリースページから qector-claude-desktop-1.0.6.mcpb をダウンロードします。
2. Claude Desktop → Settings → Extensions → Advanced settings → Install Extension → .mcpb を選択 → Enable。
3. Claude Desktop を完全に終了し（システムトレイ → Quit）、再度開きます。8 ツールの安全プロファイルを読み込むには、拡張機能を完全に再起動する必要があります。

スクリプトから（同じ結果、監査可能）：

python scripts/configure_claude_desktop.py --check-only   # preview, no changes
python scripts/configure_claude_desktop.py --confirm      # writes claude_desktop_config.json + installs extension
# Restart Desktop afterwards

Desktop の確認：

• C:\Users\<you>\AppData\Roaming\Claude\claude_desktop_config.json に qector-library が含まれ（スクリプトを使用した場合）、extensions-installations.json に ant.dir.gh.guillaumelessard.qector が含まれていることを確認します。
• C:\Users\<you>\AppData\Local\Claude\logs\mcp.log に QECTOR Server started and connected → initialize → tools/list → result が表示され（Server disconnected がないことを）確認します。

オプション C — ソースから（監査可能、オフライン）

git clone https://github.com/GuillaumeLessard/qector-claude-plugin.git
cd qector-claude-plugin

# Install for every Python you use (Windows has both 3.11 and 3.12 via py launcher)
python -m pip install -r requirements.txt          # → numpy 2.2.6, mcp 1.29.0, qector 1.0.0
py -3 -m pip install -r requirements.txt           # ← do this too if py -3 exists

# Verify
python scripts/qector_runtime_check.py             # → status: ok, failures: []
python scripts/qector_system_setup.py --check-only # → dry_run_pending_approval
python scripts/qector_system_setup.py --confirm    # → ready, theorem_1_faithful: true

トラブルシューティング

症状	原因	対処方法
Server disconnected / Unable to connect to extension server	いずれかの Python に古い mcp 1.26.0 がインストールされている、インストール済み拡張機能に scripts/ がない、または古いビルドでパスにスペースが含まれている	py -3 -m pip show mcp と python -m pip show mcp の両方が ≥1.28.1 である必要があります。それぞれに対して py -3 -m pip install -r requirements.txt --upgrade を実行してください。python scripts/configure_claude_desktop.py --confirm を再実行し（ランチャーが正しくコピーされるようになりました）、Desktop を完全に再起動してください。それでも失敗する場合は、拡張機能の Python interpreter フィールドに C:\Program Files\Python311\python.exe（または C:\Program Files\Python312\python.exe）を設定してください。
No Python 3.9-3.13 interpreter found	python が PATH にない、または 3.14 のみが利用可能	python.org から Python 3.11/3.12 をインストールするか、QECTOR_PYTHON=C:\Program Files\Python311\python.exe を設定してください（環境変数または拡張機能の interpreter フィールド）。
This extension may not work until all requirements are met	Desktop のバージョンが 0.10.0 未満、または Python がない	Desktop を更新し（≥0.10.0、現在の 1.34+ で問題ありません）、Desktop が実際に使用する Python（Windows では py -3）に mcp/qector がインストールされていることを確認してください。
qector-decoder-v3 not found	pip が別の Python にインストールした	python -m pip install -r requirements.txt および py -3 -m pip install -r requirements.txt を実行し、* -m pip show qector-decoder-v3 で両方を確認してください。

QECTOR の構成

MCP サーバー	目的	ツール	デフォルト
qector-library	結果をすべて検証済みの、安定した固定デコード機能	8	✅ 有効
qector-research	暫定的な研究およびエビデンス関連ツール	29	明示的なオプトイン
qector-admin	二重確認を伴う、権限が必要なローカル操作	3	明示的なオプトイン
qector-desktop-mcp	Claude Desktop の安全なプロファイルアダプター	8	✅ Desktop で有効

サーバーに加えて、セットアップ、事実、定理、再現、しきい値の一括評価、Wilson 区間、 検出器のエラーモデル、コード検査、ベンチマーク、sinter テンプレート、検証に対応する 11 個のスラッシュコマンド、5 つの特化型エージェント（研究者、開発者、バリデーター、システム管理者、 ハードウェアエンジニア）、そして数学の基礎、 アーキテクチャ、BP OSD、2 段階 CSS、時空間コード、デコーダーの詳細解説、 DEM パイプライン、LER の方法論、pymatching との互換性、バッチデコード、 再現性、テスト戦略、デプロイ、リリースエンジニアリング、 ライセンス、教育、運用を網羅する 28 個のスキルがあります。

成果物と整合性

ビルダーは決定論的です。タイムスタンプを固定することで、再ビルドしてもすべてのビットが 一致するため、以下のハッシュは今後も変わりません。

成果物	SHA-256
dist/qector-claude-plugin-1.0.6.zip	46ae976105d9813ef615985f30fe23cd76cf2ca11d63ee5de86758e4402903c5
dist/qector-claude-plugin-source-1.0.6.zip	4370c322b9e2fa083f841ee7a15e1468b6f991702db56d4779bd8ddb530def11
dist/qector-claude-desktop-1.0.6.mcpb	fbf9bb9a1254d4867093279a07b715041862f8c9ce71aff1201409b6cccc616c

成果物ごとのサイドカーファイル、統合された SHA256SUMS、SPDX 2.3 SBOM、および 各ファイルをリリースコミットとランタイムの固定バージョンに結び付ける 来歴記録は dist/ にあります。server.json の MCP Registry 記述子は、 Desktop バンドルとバイト単位で一致します。

システム要件

コンポーネント	要件
Python	3.9 から 3.13 まで。配布されるランチャーによって強制されます
プラットフォーム	Windows、macOS、Linux
バックエンドエンジン	qector-decoder-v3==1.0.0、ネイティブ Rust / PyO3 ホイール
MCP ランタイム	mcp>=1.28.1,<2
科学技術スタック	numpy>=1.26,<2.3、cryptography>=48.0.1,<50
ネットワーク	デフォルトでは使用しません。明示的な PyPI の鮮度確認が 1 つあります
GPU	あっても任意です。あらゆる環境での性能は保証していません

セキュリティとプライバシー

デフォルトのインストールでは、ローカルの stdio 経由で安定した 8 個のツールのみを公開します。 研究用サーバーと管理用サーバーを有効にするには明示的な操作が必要で、 権限が必要な操作には呼び出しごとの確認を求めます。また、各プロセスが それぞれ独自の呼び出し予算を適用するため、エージェントが暴走しても マシンに影響する前に上限に達します。セッションフックが永続化するのはツール名と タイムスタンプのみです。完全な信頼境界、リスク分類、スキャナーのガイダンス、 および勧告に関する方針は SECURITY.md に、ネットワークに関する 方針は PRIVACY.md に記載されています。

ドキュメント

ドキュメント	パス
ユーザーマニュアル	docs/User_Manual.md
MCP API リファレンス	MCP_API.md
v1.0.6 リリースのお知らせ	RELEASE_BODY_v1.0.6.md
リリースノート	RELEASE_NOTES_v1.0.6.md
変更履歴	CHANGELOG.md
Desktop のセットアップ	CLAUDE_DESKTOP.md
検証ゲート	RELEASE_VALIDATION.md

開発

python -m unittest discover -s tests -v     # mathematical + protocol suite
python scripts/validate_source.py           # source structure gate
python scripts/validate_plugin_bundle.py    # built bundle gate
python scripts/release_validate.py          # metadata cross check, zero deps
python scripts/build_release.py --all       # deterministic artifacts

CI は main へのすべてのプッシュに対して、同じゲートを適用します。v* でタグを付けると、すべての成果物をビルドし、GitHub リリースを公開して、 MCP Registry のエントリーを自動的に更新します。

ライセンス

プロプライエタリ。Copyright © 2026 Guillaume Lessard / iD01t Productions。LICENSE.md を参照してください。 qector-decoder-v3 バックエンドは、個人、学術、教育、および非営利の研究目的では無料で利用できます。商用利用には qector.store/pricing からライセンスを取得する必要があります。

お問い合わせ

ウェブサイト https://www.qector.store · ライセンス [email protected] · サポート [email protected] · セキュリティに関する報告 [email protected]（非公開）

QECTOR Claude Plugin v1.0.6
qector-decoder-v3 v1.0.0 を基盤として構築 · Rust / PyO3 コア
すべての訂正を H c = s (mod 2) と照合して検証