QECTOR Quantum Error Correction

What QECTOR Quantum Error Correction does

QECTOR Quantum Error Correction MCP server provides a local MCP interface for quantum error-correction workflows in Claude Code and Claude Desktop. It packages the published qector-decoder-v3==1.0.0 engine and separates its capabilities into four MCP servers:

• qector-library provides the frozen stable decoding surface with eight tools enabled by default.
• qector-research provides 29 provisional research and evidence tools that require explicit opt-in.
• qector-admin provides three privileged local-operation tools with double confirmation.
• qector-desktop-mcp supplies the eight-tool safe profile used by Claude Desktop.

The project is intended for local, auditable quantum error-correction work. Its default configuration performs no network requests, which suits offline and restricted environments.

How it works

Each correction returned through the stable MCP surface is checked against the binary parity relation H c = s (mod 2) before it leaves the process. This validation is designed to reject or identify results that do not satisfy the supplied syndrome relationship. Claims also carry a machine-checkable provenance class, allowing downstream users to distinguish the status of a result.

The server communicates with Claude clients over local stdio. Claude Code uses the marketplace plugin, while Claude Desktop uses an installable .mcpb extension or the repository's configuration script. Web, mobile, and Cowork support are not available through the local implementation; a hosted Streamable HTTP connector is listed as future roadmap work.

Setup and configuration

Python 3.9 through 3.13 is supported, with Python 3.11 or 3.12 recommended. Python 3.14 and later are deliberately rejected. The installation also requires pip and Claude Code 2.0 or later, or Claude Desktop 0.10.0 or later.

Claude Code users can add the GitHub marketplace and install the qector plugin. Claude Desktop users can install the release .mcpb through the Extensions settings, then fully restart the application. Installation from source is also supported through the repository's requirements file and verification scripts.

Interpreter discovery checks an administrator-selected interpreter first, followed by platform-specific Python commands. Set QECTOR_PYTHON to an absolute Python executable path when automatic discovery selects the wrong interpreter or when multiple Python installations are present. The launchers support Windows, macOS, and Linux.

Tools and capabilities

The QECTOR Quantum Error Correction MCP server exposes stable decoding, research, evidence, and local administration surfaces rather than putting every capability in one default profile. The stable library is enabled by default; research and administrative servers are opt-in. The Desktop adapter exposes the safe eight-tool profile.

The repository also includes 11 slash commands, five agents, and 28 skills for setup, facts, theorem work, reproduction, threshold sweeps, Wilson intervals, detector error models, code inspection, and benchmarking. These are adjacent Claude plugin features, not all MCP tools.

Limitations and notes

The local transport is restricted to Claude Code and Claude Desktop in the documented installation paths. It cannot provide access to web or mobile clients. Research tools are provisional and are not enabled by default, while administrative operations require double confirmation. A compatible Python installation and matching package environment must be available to the launcher. If more than one Python installation is used, dependencies may need to be installed for each interpreter.