Back to Browse

Qector Claude Plugin MCP Server

Developer ToolsUse Caution3.5MCP RegistryLocal
Free

Server data from the Official MCP Registry

Local quantum error correction tools; decoder output verified against H c = s (mod 2).

About

Local quantum error correction tools; decoder output verified against H c = s (mod 2).

Security Report

3.5
Use Caution3.5High Risk

This is a research-focused MCP server for quantum error correction (QECTOR) with generally sound input validation and fail-closed decode verification. However, there are notable concerns: subprocess execution without comprehensive path validation, hardcoded environment variable defaults that could mask misconfigurations, optional network calls (PyPI) that bypass explicit user control at the tool level, and insufficient logging of security-relevant events. The server's permissions (network_http, subprocess, env_vars, file operations) are reasonable for its stated research purpose, but implementation gaps warrant attention before production use. Supply chain analysis found 4 known vulnerabilities in dependencies (0 critical, 4 high severity).

3 files analyzed · 11 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

subprocess

Check that this permission is expected for this type of plugin.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

system_info

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-guillaumelessard-qector-desktop": {
      "args": [
        "-y",
        "github:GuillaumeLessard/qector-claude-plugin"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

QECTOR Claude Plugin 2.0.1

Air-gapped, schema-validated, audited quantum error correction for Claude Code and Claude Desktop, built on qector-decoder-v3==1.0.1.

Every correction returned by an MCP tool is checked against the parity relation H c = s (mod 2) before it leaves the process. Every request is validated against a JSON Schema 2020-12 input schema before any decoder code runs, and every response is validated against the tool's advertised output schema before it is written. The default server opens no listening socket, launches no process, verifies its own files at startup, and can keep a hash-chained audit log.

1 secure MCP server (12 tools default, 41 in research profile) · 3 standalone servers · 11 commands · 5 agents · 28 skills · contract 2.0 · mcp 1.30+ and 2.x · Python 3.10–3.13 · air-gapped by default

Why 2.0.0

The 1.0.x line made claims its process could not enforce. 2.0.0 turns those claims into mechanisms and states what remains:

1.0.62.0.0
Network"zero egress" in the docs; check_pypi=true opened a connectionin-process guard installed before the first MCP frame (defence in depth; host egress rule documented for a hard guarantee); PyPI check refused
ValidationSDK-dependent input check, no output checkown Draft 2020-12 validator both ways; 91 committed schema files
IntegritynoneINTEGRITY.json verified at startup, strict by default
Auditnoneoptional hash-chained JSONL log
SDKmcp==1.26.0 (3 CVEs), broke on mcp 2.xmcp>=1.30,<3; same wire output on both generations
Releasethree different trees labelled 1.0.6deterministic builder that refuses a dirty tree, hashed requirements.lock, per-archive manifest + RELEASE_COMMIT, Ed25519-signed manifests and SHA256SUMS, Sigstore log entry
Honesty about the wheelnot mentionednative TLS client and billing endpoint disclosed in airgap_status and SECURITY.md
Wheel defectscolor_code d=3 (1 check, no logicals) exposed as decodable; rotated_surface labelled distance d while a weight-2 error is undetectableper-family health probe with a checked effective_distance (exact for graphlike codes via the matching graph's shortest odd-parity cycle, bounded enumeration otherwise; never the wheel's label); degenerate refused, weak warned on every result; a corrected rotated_surface_corrected family built by the plugin and verified at construction (mcp/qector_codes.py). 2.0.1 pins qector-decoder-v3==1.0.1, which fixes these families upstream; the probe now verifies every one at its label
Shipped bugssinter_task_template crashed on every call; DEM collapse ignored the 3rd+ mechanismfixed, with regression tests

Installation

Claude Code

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

The plugin registers qector-secure (mcp/mcp_server_secure.py --profile safe, QECTOR_AIR_GAPPED=1). Interpreter resolution goes through scripts/qector-python (QECTOR_PYTHON → python3.13…python3.10 → python3 → python → well-known Homebrew / python.org / pyenv locations, 3.10–3.13), a POSIX sh script.

Windows (Claude Code): a plugin manifest has one command for every platform and a sh script is not a Win32 executable, so on native Windows the plugin's server starts only where sh is on PATH (Git for Windows with "Unix tools" selected, or WSL). Otherwise register the server once by hand with the Windows launcher, which also serves the hooks:

claude mcp add qector-secure -e QECTOR_AIR_GAPPED=1 -e QECTOR_INTEGRITY_STRICT=1 -e QECTOR_SILENT=1 -- cmd /c "<plugin root>\scripts\qector-python.cmd" "<plugin root>\mcp\mcp_server_secure.py" --profile safe

The Claude Desktop extension does not have this limitation: its manifest carries a win32 override that launches scripts/qector-python.ps1 through powershell.exe.

The hooks (hooks/hooks.json) run in shell form, which Claude Code executes with Git Bash on Windows; without Git for Windows they report an error on each session start and the (optional) usage log is not written. The server itself is unaffected.

Claude Desktop

Install qector-claude-desktop-2.0.1.mcpb (Settings → Extensions → Advanced → Install Extension). The bundle runs the same secure server in strict-integrity mode; the optional Audit log directory setting enables the hash-chained log. A platform-specific bundle with the runtime vendored into server/lib can be built with scripts/build_release.py --desktop --bundle-lib <wheelhouse>.

Air-gapped laboratory

See AIRGAP.md: build a wheelhouse on a connected host (scripts/build_wheelhouse.py), carry it with SHA256SUMS, run scripts/install_offline.sh / .ps1 on the lab machine, and apply a host egress rule.

From source

git clone https://github.com/GuillaumeLessard/qector-claude-plugin.git
cd qector-claude-plugin
python -m pip install -r requirements.lock      # exact tested closure (Python 3.10-3.13)
QECTOR_SILENT=1 python scripts/qector_runtime_check.py

The tool surface

ServerEntry pointToolsDefault
qector-securemcp/mcp_server_secure.py --profile safe12✅ Claude Code & Desktop
qector-secure --profile researchsame41opt-in
qector-librarymcp/mcp_server_library.py8legacy
qector-researchmcp/mcp_server_qector_bench.py29opt-in
qector-adminmcp/mcp_server_admin.py3opt-in, QECTOR_ADMIN_ENABLED=1

Control-plane tools of the secure server: airgap_status, integrity_check, schema_catalog, audit_log_status. Full contract in MCP_API.md; every schema in schemas/.

Verification gates

python scripts/release_validate.py                 # manifests, pins, disclosures
python scripts/validate_source.py                  # tree shape
python scripts/export_schemas.py --check           # schemas/ in sync with the servers
python scripts/generate_integrity_manifest.py --check
QECTOR_SILENT=1 python -m unittest discover -s tests -v   # unit, contract and live stdio conformance tests
python mcp/tests/test_mcp_stdio.py                 # 5 servers over real stdio
ruff check .
python scripts/build_release.py --all --signing-key <pem> && python scripts/validate_plugin_bundle.py
python scripts/sign_release.py --verify dist --pubkey <published key>     # see SECURITY.md

CI runs the suite on Python 3.10–3.13 against both mcp 1.x (patched) and mcp 2.x.

System requirements

ComponentRequirement
Python3.10 through 3.13 (the MCP SDK needs 3.10+; the decoder wheels stop at 3.13)
PlatformsLinux, macOS; Windows via the Desktop extension, WSL, or Git for Windows (see Installation)
Backendqector-decoder-v3==1.0.1 (Rust / PyO3 wheel)
MCP SDKmcp>=1.30,<3
Validationjsonschema>=4.18
Networknone required; the plugin's only network-capable option (PyPI check) is refused in air-gapped mode, and the wheel's native TLS client is disclosed, never called (see Security)

Security and privacy

SECURITY.md (trust boundaries, tool classification, startup gates, the wheel's native network surface), THREAT_MODEL.md (assets, actors, controls, residual risks), PRIVACY.md, AIRGAP.md. Vulnerability reports: admin@qector.store.

Documentation

DocumentPath
Ten-minute reviewer checklistREVIEWER_GUIDE.md
MCP API contract 2.0MCP_API.md
Air-gapped deploymentAIRGAP.md
Threat modelTHREAT_MODEL.md
Anthropic collaboration proposalANTHROPIC_COLLABORATION_PROPOSAL.md
Release notesRELEASE_NOTES_v2.0.1.md · RELEASE_NOTES_v2.0.0.md · CHANGELOG.md
Upstream wheel defect report (rotated surface distance)docs/UPSTREAM_ISSUE_rotated_surface_distance.md · scripts/probe_wheel_distance.py
User manualdocs/User_Manual.md
Desktop setupCLAUDE_DESKTOP.md
Validation gatesRELEASE_VALIDATION.md

License

Proprietary. Copyright © 2026 Guillaume Lessard / iD01t Productions. See LICENSE.md. The qector-decoder-v3 backend is free for personal, academic, educational and non-commercial research; commercial use requires a licence from qector.store/pricing.

Website https://www.qector.store · Licensing, support and security disclosure admin@qector.store

Reviews

No reviews yet

Be the first to review this server!