{
  "markdown": "# QECTOR Claude Plugin\n\n**Verified quantum error correction for Claude. Local, deterministic, and\nmathematically guaranteed on every machine you work on.**\n\nQECTOR integrates the published `qector-decoder-v3==1.0.0` engine with\nClaude Code and Claude Desktop, turning both into a production grade QEC\nengineering environment. Every correction returned by an MCP server is\nverified against the parity relation `H c = s (mod 2)` before it leaves\nthe process, every claim carries a machine checkable provenance class,\nand the default configuration performs no network request of any kind.\n\n> **4 MCP servers · 8 stable / 29 research / 3 admin tools · 11 commands\n> · 5 agents · 28 skills · zero egress by default**\n\n> **Latest release — [v1.0.6](RELEASE_NOTES_v1.0.6.md)** · Claude.ai\n> marketplace compliance (launchers to `scripts/`, canonical manifests),\n> environment-agnostic `/qec-setup`, deterministic artifacts. See the\n> [release announcement](RELEASE_BODY_v1.0.6.md).\n\n---\n\n## Why v1.0.6\n\nVersion 1.0.6 completes the portability and compliance story that 1.0.5\nstarted, then layers on marketplace correctness and universal setup. Two\nproblems drove it: modern operating systems no longer hand you Python on a\npredictable command name (macOS, Debian, Ubuntu, and Fedora ship `python3`\nwithout bare `python`, while Windows adds its own resolver quirks), and the\nclaude.ai marketplace approval pipeline rejects plugins that ship\nexecutables in `bin/`. This release retires both failure classes, permanently.\n\n**1. A universal, compliant launcher ships inside every artifact.**\n\n* The plugin archive, the source distribution, and the Desktop bundle all\n  carry `scripts/qector-python` (POSIX sh) and `scripts/qector-python.cmd`\n  (Windows). They live in `scripts/`, not `bin/`: claude.ai-hosted plugins\n  may not ship `bin/` executables because they land on PATH without ever\n  appearing on the admin approval surface. A validator now hard-fails any\n  build that reintroduces `bin/`.\n* Resolution is governed, not guessed. An administrator pinned interpreter\n  wins first, then `python3`, then `python`, with the Windows `py` launcher\n  tried ahead of them all.\n* The supported window is enforced, not documented. Only Python 3.9\n  through 3.13 executes, matching the published native wheel matrix; an\n  out of range machine receives precise remediation guidance instead of\n  a deep import crash.\n* Pinning is first class on both surfaces. Set `QECTOR_PYTHON` to an\n  absolute interpreter path and every launcher honors it above discovery.\n\n**2. The marketplace surface is canonical.**\n\nBoth `plugin.json` and `marketplace.json` use only documented fields and a\nrelative same-repo plugin source — the form every official marketplace uses\nand the only form every sync path can resolve. The Desktop MCPB carries a\n`win32` platform override so Windows always selects the `.cmd` launcher.\n\n**3. Setup works in every environment.**\n\n`/qec-setup` detects sandboxed and remote environments (claude.ai code\nexecution, Cowork, containers without a project checkout) and falls back to\nnative diagnostics instead of dead ending on a missing local script — and it\nreports honestly which path it used.\n\n## Platform support\n\n| Surface | Install path | Status |\n|:--------|:-------------|:-------|\n| Claude Code CLI | marketplace plugin over local stdio | ✅ Windows, macOS, Linux |\n| Claude Desktop | `.mcpb` bundle with single click install | ✅ Windows, macOS |\n| Web, iOS, Android, Cowork | hosted remote connector (Streamable HTTP with OAuth) | 🗺️ roadmap 1.1.x |\n| Air gapped and restricted estates | local stdio, fully offline default | ✅ |\n\nLocal stdio cannot reach web or mobile by architecture; the hosted\nconnector is the engineered path to those surfaces and lands in 1.1.x.\n\n## Installation\n\n### Prerequisites\n\n| Requirement | How to check | Expected |\n|:------------|:-------------|:---------|\n| **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 |\n| **pip** | `python -m pip --version` | any recent |\n| **Claude Code** ≥2.0 or **Claude Desktop** ≥0.10.0 | `claude --version` | `2.1.x` / `1.34+` |\n\n> **Python with spaces in path** (e.g. `Anthropic Skills and agents`) is now handled — the Desktop extension in `v1.0.6` uses `python` directly (no `${__dirname}` launcher) and the Code plugin uses `scripts/qector-python`. If you still see `Server disconnected`, set `QECTOR_PYTHON` (see Troubleshooting).\n\n### Option A — Claude Code (marketplace, 30 s)\n\n```bash\n# 1. Add the marketplace (once)\nclaude plugin marketplace add GuillaumeLessard/qector-claude-plugin\n\n# 2. Install the plugin\nclaude plugin install qector@qector-tools\n# When prompted for Python interpreter: leave empty for auto-resolve,\n# or paste an absolute path like C:\\Program Files\\Python311\\python.exe\n\n# 3. Verify\nclaude plugin list                          # → qector@qector-tools 1.0.6 enabled\nclaude plugin validate . --strict           # → ✔ Validation passed\npython scripts/qector_runtime_check.py      # → status: ok, mcp 1.29.0\n```\n\n### Option B — Claude Desktop (single click)\n\n**Via UI (recommended):**\n\n1. Download `qector-claude-desktop-1.0.6.mcpb` from the [release page](https://github.com/GuillaumeLessard/qector-claude-plugin/releases/tag/v1.0.6).\n2. Claude Desktop → Settings → Extensions → Advanced settings → **Install Extension** → select the `.mcpb` → **Enable**.\n3. **Fully quit** Claude Desktop (system tray → Quit) and reopen — the extension needs a full restart to load the 8-tool safe profile.\n\n**Via script (same result, auditable):**\n\n```bash\npython scripts/configure_claude_desktop.py --check-only   # preview, no changes\npython scripts/configure_claude_desktop.py --confirm      # writes claude_desktop_config.json + installs extension\n# Restart Desktop afterwards\n```\n\n**Verify Desktop:**\n\n- `C:\\Users\\<you>\\AppData\\Roaming\\Claude\\claude_desktop_config.json` contains `qector-library` (if you used the script) and `extensions-installations.json` contains `ant.dir.gh.guillaumelessard.qector`.\n- `C:\\Users\\<you>\\AppData\\Local\\Claude\\logs\\mcp.log` shows `QECTOR Server started and connected → initialize → tools/list → result` (no `Server disconnected`).\n\n### Option C — From source (auditable, offline)\n\n```bash\ngit clone https://github.com/GuillaumeLessard/qector-claude-plugin.git\ncd qector-claude-plugin\n\n# Install for every Python you use (Windows has both 3.11 and 3.12 via py launcher)\npython -m pip install -r requirements.txt          # → numpy 2.2.6, mcp 1.29.0, qector 1.0.0\npy -3 -m pip install -r requirements.txt           # ← do this too if py -3 exists\n\n# Verify\npython scripts/qector_runtime_check.py             # → status: ok, failures: []\npython scripts/qector_system_setup.py --check-only # → dry_run_pending_approval\npython scripts/qector_system_setup.py --confirm    # → ready, theorem_1_faithful: true\n```\n\n### Troubleshooting\n\n| Symptom | Cause | Fix |\n|:--------|:------|:----|\n| `Server disconnected` / `Unable to connect to extension server` | Old `mcp 1.26.0` on one Python, or missing `scripts/` in installed extension, or path with spaces on old builds | `py -3 -m pip show mcp` and `python -m pip show mcp` must both be `≥1.28.1` — run `py -3 -m pip install -r requirements.txt --upgrade` for each. Re-run `python scripts/configure_claude_desktop.py --confirm` (now correctly copies launchers) and **fully restart** Desktop. If still failing, set the extension's **Python interpreter** field to `C:\\Program Files\\Python311\\python.exe` (or `C:\\Program Files\\Python312\\python.exe`). |\n| `No Python 3.9-3.13 interpreter found` | `python` not on PATH or only 3.14 available | Install Python 3.11/3.12 from python.org and/or set `QECTOR_PYTHON=C:\\Program Files\\Python311\\python.exe` (environment variable or extension's interpreter field). |\n| `This extension may not work until all requirements are met` | Desktop version <0.10.0 or Python missing | Update Desktop (≥0.10.0, current 1.34+ is fine) and ensure `mcp`/`qector` installed for the Python Desktop actually uses (`py -3` on Windows). |\n| `qector-decoder-v3 not found` | `pip` installed to wrong Python | Run `python -m pip install -r requirements.txt` **and** `py -3 -m pip install -r requirements.txt` — check both with `* -m pip show qector-decoder-v3`. |\n\n## The QECTOR surface\n\n| MCP server | Purpose | Tools | Default |\n|:-----------|:--------|:------|:--------|\n| `qector-library` | Frozen stable decoding surface, every result verified | **8** | ✅ enabled |\n| `qector-research` | Provisional research and evidence tooling | **29** | explicit opt in |\n| `qector-admin` | Privileged local operations with double confirmation | **3** | explicit opt in |\n| `qector-desktop-mcp` | Claude Desktop safe profile adapter | **8** | ✅ on Desktop |\n\nAlongside the servers: **11 slash commands** for setup, facts, theorems,\nreproduction, threshold sweeps, Wilson intervals, detector error models,\ncode inspection, benchmarking, sinter templates, and validation;\n**5 specialized agents** (researcher, developer, validator, sysadmin,\nhardware engineer); and **28 skills** spanning math foundations,\narchitecture, BP OSD, two stage CSS, space time codes, decoders deep\ndive, DEM pipelines, LER methodology, pymatching compatibility, batch\ndecoding, reproducibility, testing strategy, deployment, release\nengineering, licensing, education, and operations.\n\n## Artifacts and integrity\n\nThe builder is deterministic: fixed timestamps make every rebuild bit\nidentical, so the hashes below are stable forever.\n\n| Artifact | SHA-256 |\n|:---------|:--------|\n| `dist/qector-claude-plugin-1.0.6.zip` | `46ae976105d9813ef615985f30fe23cd76cf2ca11d63ee5de86758e4402903c5` |\n| `dist/qector-claude-plugin-source-1.0.6.zip` | `4370c322b9e2fa083f841ee7a15e1468b6f991702db56d4779bd8ddb530def11` |\n| `dist/qector-claude-desktop-1.0.6.mcpb` | `fbf9bb9a1254d4867093279a07b715041862f8c9ce71aff1201409b6cccc616c` |\n\nPer artifact sidecars, a combined `SHA256SUMS`, an SPDX 2.3 SBOM, and\nprovenance records binding each file to its release commit and runtime\npins live under `dist/`. The MCP Registry descriptor in `server.json`\nmatches the Desktop bundle byte for byte.\n\n## System requirements\n\n| Component | Requirement |\n|:----------|:------------|\n| Python | 3.9 through 3.13, enforced by the shipped launchers |\n| Platforms | Windows, macOS, Linux |\n| Backend engine | `qector-decoder-v3==1.0.0`, native Rust / PyO3 wheels |\n| MCP runtime | `mcp>=1.28.1,<2` |\n| Scientific stack | `numpy>=1.26,<2.3`, `cryptography>=48.0.1,<50` |\n| Network | none by default; one explicit PyPI freshness check exists |\n| GPU | optional at most; no portable performance claims are published |\n\n## Security and privacy\n\nThe default installation exposes exactly eight stable tools over local\nstdio. Research and administrative servers require deliberate enabling,\nprivileged operations demand per call confirmation, and every process\nenforces its own call budgets so a runaway agent hits a ceiling instead\nof your machine. Session hooks persist nothing beyond a tool name and a\ntimestamp. Full trust boundaries, risk classifications, scanner guidance,\nand advisory posture are documented in [SECURITY.md](SECURITY.md), with\nthe network stance in [PRIVACY.md](PRIVACY.md).\n\n## Documentation\n\n| Document | Path |\n|:---------|:-----|\n| User manual | [docs/User_Manual.md](docs/User_Manual.md) |\n| MCP API reference | [MCP_API.md](MCP_API.md) |\n| v1.0.6 release announcement | [RELEASE_BODY_v1.0.6.md](RELEASE_BODY_v1.0.6.md) |\n| Release notes | [RELEASE_NOTES_v1.0.6.md](RELEASE_NOTES_v1.0.6.md) |\n| Changelog | [CHANGELOG.md](CHANGELOG.md) |\n| Desktop setup | [CLAUDE_DESKTOP.md](CLAUDE_DESKTOP.md) |\n| Validation gates | [RELEASE_VALIDATION.md](RELEASE_VALIDATION.md) |\n\n## Development\n\n```bash\npython -m unittest discover -s tests -v     # mathematical + protocol suite\npython scripts/validate_source.py           # source structure gate\npython scripts/validate_plugin_bundle.py    # built bundle gate\npython scripts/release_validate.py          # metadata cross check, zero deps\npython scripts/build_release.py --all       # deterministic artifacts\n```\n\nCI enforces the same gates on every push to main. Tagging with `v*`\nadditionally builds all artifacts, publishes the GitHub release, and\nupdates the MCP Registry entry automatically.\n\n## License\n\nProprietary. Copyright © 2026 Guillaume Lessard / iD01t Productions. See\n[LICENSE.md](LICENSE.md). The `qector-decoder-v3` backend is free for\npersonal, academic, educational, and non commercial research; commercial\nuse requires a license from\n[qector.store/pricing](https://qector.store/pricing).\n\n## Contact\n\nWebsite <https://www.qector.store> · Licensing <admin@qector.store> ·\nSupport <admin@qector.store> · Security disclosure\n<admin@qector.store> (private)\n\n<p align=\"center\">\n<strong>QECTOR Claude Plugin v1.0.6</strong><br/>\nBuilt on <code>qector-decoder-v3</code> v1.0.0 · Rust / PyO3 core<br/>\nEvery correction verified against <code>H c = s (mod 2)</code>\n</p>\n\n",
  "bytes": 13051,
  "sha": "56bd8021e63f8342e7c0fb24d2d43d2129617c903490c39d2a75054a30f74129",
  "repo_slug": "guillaumelessard/qector-claude-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_guillaumelessard_qector_deskto_e42524f3/readme"
}