Quantum Code Validator

Provides an MCP server for static validation of quantum code and reference lookups, currently supporting PennyLane.

python

0

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "qyusu-quantum-code-validator": {
      "command": "uv",
      "args": [
        "--directory",
        "/your/mcp/server/directory/quantum-code-validator",
        "run",
        "server.py",
        "--transport",
        "stdio"
      ]
    }
  }
}

You run an MCP server called Quantum Code Validator to statically validate quantum computing library code and look up reference documentation. It focuses on PennyLane today and is designed to be extended to other libraries in the future, helping you catch usage errors early and verify method usage against official guidance.

How to use

You interact with the Quantum Code Validator through an MCP client. Use the two main capabilities to improve your quantum code workflows: first, validate code statically to check syntax, compilation readiness, and library method usage; second, request method reference documentation for specific library versions to confirm correct usage patterns.

How to install

# Prerequisites: Python environment and a working MCP client

# Step 1: Install uv if not already installed
curl -LsSf https://astral.sh/uv/install.sh | sh

# Step 2: Prepare your environment and dependencies
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Step 3: Install dependencies for the MCP server via uv
uv sync

# Step 4: Run the MCP server
uv run src/server.py

Configuration and run

{
  "mcpServers": {
      "quantum_code_validator": {
          "command": "uv",
          "args": [
              "--directory",
              "/your/mcp/server/directory/quantum-code-validator",
              "run",
              "server.py",
              "--transport",
              "stdio"
          ]
      }
  }
}

Notes and tips

If you plan to host your MCP server remotely or want to connect via a client, ensure you follow the exact command and arguments shown in the configuration snippet above. Keep your Python environment isolated and avoid mixing system-wide packages with project dependencies to prevent version conflicts.

Available tools

validate_quantum_method_by_static

Validates quantum code by checking syntax via Python ast, compiling with py_compile, and comparing method usage against official library documentation for correctness.

request_quantum_method_reference

Fetches method documentation for a specified quantum library method and version to guide correct usage.