Add MCP

.devcontainer/devcontainer.json

@@ -58,6 +58,13 @@
             }
         }
     },
+    "forwardPorts": [8081],
+    "portsAttributes": {
+        "8081": {
+            "label": "QDK Chemistry MCP",
+            "onAutoForward": "silent"
+        }
+    },
     "features": {
         "ghcr.io/devcontainers/features/git:1": {},
         "ghcr.io/devcontainers/features/node:2": {

.github/plugin/marketplace.json

@@ -0,0 +1,18 @@
+{
+  "name": "qdk-chemistry",
+  "owner": {
+    "name": "Microsoft"
+  },
+  "metadata": {
+    "description": "QDK Chemistry agent plugins",
+    "version": "2.1.0"
+  },
+  "plugins": [
+    {
+      "name": "qdk-chemistry",
+      "description": "Run QDK Chemistry workflows with specialized agents, skills, and MCP tools.",
+      "version": "2.1.0",
+      "source": "copilot-plugins/qdk-chemistry"
+    }
+  ]
+}

.github/scripts/check_version_alignment.py

@@ -11,6 +11,9 @@
 - python/src/qdk_chemistry/utils/telemetry.py (uses importlib.metadata with fallback)
 - docs/source/conf.py (uses Path.read_text())
 - docs/source/changelog.rst (must have entry for current version)
+- copilot-plugins/qdk-chemistry/plugin.json (matches VERSION)
+- copilot-plugins/qdk-chemistry/skills/*/SKILL.md (matches VERSION)
+- .github/plugin/marketplace.json (matches plugin.json)
 
 Exit codes:
     0: All versions are aligned
@@ -22,6 +25,7 @@
 # Licensed under the MIT License. See LICENSE.txt in the project root for license information.
 # --------------------------------------------------------------------------------------------
 
+import json
 import re
 import sys
 from pathlib import Path
@@ -150,6 +154,60 @@ def check_versions() -> int:
     else:
         errors.append("docs/source/changelog.rst: file not found")
 
+    # Check 7: plugin and skill versions match VERSION
+    plugin_manifest = repo_root / "copilot-plugins/qdk-chemistry/plugin.json"
+    marketplace_manifest = repo_root / ".github/plugin/marketplace.json"
+    try:
+        plugin_version = json.loads(plugin_manifest.read_text())["version"]
+        if plugin_version != canonical_version:
+            errors.append(
+                "copilot-plugins/qdk-chemistry/plugin.json: version is "
+                f"'{plugin_version}', expected '{canonical_version}' from VERSION"
+            )
+
+        skills_directory = plugin_manifest.parent / "skills"
+        skill_files = sorted(skills_directory.glob("*/SKILL.md"))
+        if not skill_files:
+            errors.append("copilot plugin skills: no SKILL.md files found")
+        expected_skill_version = f"v{canonical_version}"
+        for skill_file in skill_files:
+            content = skill_file.read_text()
+            frontmatter = content.split("---", 2)
+            version_match = (
+                re.search(
+                    r"^version:\s*['\"]?([^'\"\s]+)['\"]?\s*$",
+                    frontmatter[1],
+                    re.MULTILINE,
+                )
+                if len(frontmatter) == 3
+                else None
+            )
+            skill_label = skill_file.relative_to(repo_root)
+            if version_match is None:
+                errors.append(f"{skill_label}: missing version in YAML frontmatter")
+            elif version_match.group(1) != expected_skill_version:
+                errors.append(
+                    f"{skill_label}: version is '{version_match.group(1)}', "
+                    f"expected '{expected_skill_version}' from VERSION"
+                )
+
+        # Check 8: plugin marketplace entries match the plugin manifest version
+        marketplace = json.loads(marketplace_manifest.read_text())
+        marketplace_versions = {
+            "metadata.version": marketplace["metadata"]["version"],
+            "plugins[0].version": marketplace["plugins"][0]["version"],
+        }
+        for field, marketplace_version in marketplace_versions.items():
+            if marketplace_version != plugin_version:
+                errors.append(
+                    f".github/plugin/marketplace.json: {field} is "
+                    f"'{marketplace_version}', expected '{plugin_version}' from plugin.json"
+                )
+    except (FileNotFoundError, IndexError, KeyError, json.JSONDecodeError) as exception:
+        errors.append(
+            f"plugin version manifests: invalid or missing data ({exception})"
+        )
+
     # Report results
     if errors:
         print("FAIL: Version check failed:", file=sys.stderr)
@@ -174,6 +232,9 @@ def check_versions() -> int:
     print("    - python/src/qdk_chemistry/utils/telemetry.py")
     print("    - docs/source/conf.py")
     print("    - docs/source/changelog.rst")
+    print("    - copilot-plugins/qdk-chemistry/plugin.json")
+    print("    - copilot-plugins/qdk-chemistry/skills/*/SKILL.md")
+    print("    - .github/plugin/marketplace.json")
     return 0
 
 

.gitignore

@@ -48,6 +48,7 @@ pip-delete-this-directory.txt
 
 # Unit test / coverage reports
 htmlcov/
+
 .tox/
 .nox/
 .coverage

.pipelines/pip-scripts/test-pip-wheels-windows.ps1

@@ -11,6 +11,7 @@ param(
     [string]$SrcDir        = (Resolve-Path "$PSScriptRoot\..\.." -ErrorAction Stop),
     [string]$PythonVersion = '3.11',
     [string]$RunSlowTests  = 'true',
+    [string]$Triplet       = $env:VCPKG_TRIPLET,
     [ValidateSet('conda', 'venv')]
     [string]$PythonEnv     = 'conda'
 )
@@ -48,6 +49,10 @@ Write-Host "Installing: $wheel"
 if ($LASTEXITCODE -ne 0) { throw "pip upgrade failed ($LASTEXITCODE)" }
 & $runExe @runArgs -m pip install "$wheel[test]"
 if ($LASTEXITCODE -ne 0) { throw "pip install wheel[test] failed ($LASTEXITCODE)" }
+if ($Triplet -ne 'arm64-windows-static-md') {
+    & $runExe @runArgs -c "import mcp; from qdk_chemistry.ui._mcp import MCP_AVAILABLE; assert MCP_AVAILABLE"
+    if ($LASTEXITCODE -ne 0) { throw "MCP installation smoke test failed ($LASTEXITCODE)" }
+}
 
 # ─── 3. Component Governance PipReport (non-fatal) ───────────────────────────
 Write-Host "=== Generate Component Governance PipReport ==="

.pipelines/requirements.txt

@@ -1,82 +1,66 @@
-# This file was autogenerated by uv via the following command:
-#    pip-compile --universal --python-version 3.10 --output-file requirements.txt requirements.in
-altgraph==0.17.5 ; sys_platform == 'darwin'
-    # via macholib
-auditwheel==6.6.0 ; sys_platform == 'linux'
-    # via -r requirements.in
+#
+# This file is autogenerated by pip-compile with Python 3.12
+# by the following command:
+#
+#    pip-compile --output-file=.pipelines/requirements.txt --strip-extras .pipelines/requirements.in
+#
+auditwheel==6.6.0 ; sys_platform == "linux"
+    # via -r .pipelines/requirements.in
 build==1.5.0
-    # via -r requirements.in
-colorama==0.4.6 ; os_name == 'nt'
-    # via build
-delocate==0.13.0 ; sys_platform == 'darwin'
-    # via -r requirements.in
-exceptiongroup==1.3.1 ; python_full_version < '3.11'
-    # via scikit-build-core
+    # via -r .pipelines/requirements.in
 fonttools==4.62.1
-    # via -r requirements.in
-googleapis-common-protos==1.75.0 ; sys_platform == 'linux'
+    # via -r .pipelines/requirements.in
+googleapis-common-protos==1.75.0
     # via opentelemetry-exporter-otlp-proto-grpc
-grpcio==1.80.0 ; sys_platform == 'linux'
+grpcio==1.80.0
     # via opentelemetry-exporter-otlp-proto-grpc
-macholib==1.16.4 ; sys_platform == 'darwin'
-    # via delocate
-numpy==2.2.6 ; python_full_version < '3.11'
-    # via -r requirements.in
-numpy==2.3.5 ; python_full_version >= '3.11'
-    # via -r requirements.in
-opentelemetry-api==1.42.1 ; sys_platform == 'linux'
+numpy==2.3.5
+    # via -r .pipelines/requirements.in
+opentelemetry-api==1.42.1 ; sys_platform == "linux"
     # via
-    #   -r requirements.in
+    #   -r .pipelines/requirements.in
     #   opentelemetry-exporter-otlp-proto-grpc
     #   opentelemetry-sdk
     #   opentelemetry-semantic-conventions
-opentelemetry-exporter-otlp-proto-common==1.42.1 ; sys_platform == 'linux'
+opentelemetry-exporter-otlp-proto-common==1.42.1
     # via opentelemetry-exporter-otlp-proto-grpc
-opentelemetry-exporter-otlp-proto-grpc==1.42.1 ; sys_platform == 'linux'
-    # via -r requirements.in
-opentelemetry-proto==1.42.1 ; sys_platform == 'linux'
+opentelemetry-exporter-otlp-proto-grpc==1.42.1 ; sys_platform == "linux"
+    # via -r .pipelines/requirements.in
+opentelemetry-proto==1.42.1
     # via
     #   opentelemetry-exporter-otlp-proto-common
     #   opentelemetry-exporter-otlp-proto-grpc
-opentelemetry-sdk==1.42.1 ; sys_platform == 'linux'
+opentelemetry-sdk==1.42.1 ; sys_platform == "linux"
     # via
-    #   -r requirements.in
+    #   -r .pipelines/requirements.in
     #   opentelemetry-exporter-otlp-proto-grpc
-opentelemetry-semantic-conventions==0.63b1 ; sys_platform == 'linux'
+opentelemetry-semantic-conventions==0.63b1
     # via opentelemetry-sdk
 packaging==26.2
     # via
     #   auditwheel
     #   build
-    #   delocate
     #   scikit-build-core
 pathspec==1.1.1
     # via scikit-build-core
-protobuf==5.29.6 ; sys_platform == 'linux'
+protobuf==5.29.6
     # via
     #   googleapis-common-protos
     #   opentelemetry-proto
 pybind11==3.0.4
-    # via -r requirements.in
-pyelftools==0.32 ; sys_platform == 'linux'
+    # via -r .pipelines/requirements.in
+pyelftools==0.32
     # via auditwheel
 pyproject-hooks==1.2.0
     # via build
 scikit-build-core==0.12.2
-    # via -r requirements.in
-tomli==2.4.1 ; python_full_version < '3.11'
-    # via
-    #   build
-    #   scikit-build-core
-typing-extensions==4.15.0 ; python_full_version < '3.11' or sys_platform == 'darwin' or sys_platform == 'linux'
+    # via -r .pipelines/requirements.in
+typing-extensions==4.15.0
     # via
-    #   delocate
-    #   exceptiongroup
     #   grpcio
     #   opentelemetry-api
     #   opentelemetry-exporter-otlp-proto-grpc
     #   opentelemetry-sdk
     #   opentelemetry-semantic-conventions
-    #   scikit-build-core
 urllib3==2.7.0
-    # via -r requirements.in
+    # via -r .pipelines/requirements.in

.pipelines/templates/test-pip-wheels-windows.yml

@@ -34,6 +34,7 @@ steps:
       -SrcDir "$(System.DefaultWorkingDirectory)" `
       -PythonVersion '${{ parameters.pythonVersion }}' `
       -PythonEnv $pythonEnv `
+      -Triplet '$(VCPKG_TRIPLET)' `
       -RunSlowTests '${{ parameters.runSlowTests }}'
   displayName: Test wheel (Windows, Python ${{ parameters.pythonVersion }})
   condition: ${{ parameters.condition }}

.pre-commit-config.yaml

@@ -89,6 +89,7 @@ repos:
   hooks:
   - id: markdownlint
     args: [--fix, --disable=line-length, --disable=MD024, --disable=MD029, --disable=MD033]
+    exclude: (agent_configs/|^copilot-plugins/)
     files: &all_md >
       (?x)^(
         .*\.md$|
@@ -125,9 +126,14 @@ repos:
     require_serial: true
     files: >
       (?x)^(
+        VERSION|
         python/CMakeLists\.txt|
         cpp/CMakeLists\.txt|
-        docs/source/conf\.py
+        docs/source/conf\.py|
+        \.github/scripts/check_version_alignment\.py|
+        copilot-plugins/qdk-chemistry/plugin\.json|
+        copilot-plugins/qdk-chemistry/skills/[^/]+/SKILL\.md|
+        \.github/plugin/marketplace\.json
       )$
 
   - id: check-pyi-stubs

INSTALL.md

@@ -88,6 +88,7 @@ python3 -m pip install qdk-chemistry
 > **NOTE:** On Python 3.14, `qiskit-aer` is omitted from the `qiskit-extras` and `all` extras on Linux ARM64 (aarch64), because Qiskit does not yet publish a Python 3.14 wheel for that platform. See the [Optional Extras](#optional-extras) table below for details.
 >
 > **NOTE:** On Windows, PySCF is skipped from the `plugins` extra because it publishes no Windows wheels; on Windows arm64 the Qiskit stack, PennyLane, RDKit and the Discovery backend are skipped as well. See [Notes for Windows users](#notes-for-windows-users).
+> The MCP extra is also omitted from `[all]` and `[test]` on Windows arm64.
 
 ### Step 3: Verify the installation
 
@@ -118,15 +119,16 @@ If you chose the minimal `pip install qdk-chemistry` above, you can add specific
 |-------|-------------|-------------------|
 | `coverage` | Coverage reporting tools | coverage, pytest, pytest-cov, gcovr |
 | `jupyter` | Jupyter notebook support | ipykernel, pandas |
+| `mcp` | MCP server, transports, workspace binding, and MCP Apps integration | mcp |
 | `plugins` | Third-party quantum chemistry backends | PySCF (no Windows wheels) |
 | `qiskit-extras` | Qiskit ecosystem packages | qiskit, qiskit-aer, qiskit-nature |
 | `openfermion-extras` | OpenFermion ecosystem packages | openfermion |
 | `networkx-extras` | NetworkX ecosystem packages | networkx |
 | `docs` | [Sphinx documentation build tools](docs/README.md) | sphinx, sphinx-rtd-theme, myst-parser, breathe, sphinx-autodoc-typehints, sphinx-inline-tabs, sphinxcontrib-napoleon, sphinxcontrib-bibtex, sphinx_copybutton |
 | `qre` | Quantum Resource Estimator support | qdk[qre,jupyter]>=1.30.0 |
 | `dev` | Development and testing tools | pytest, ruff, mypy, and related tooling |
-| `test` | Testing tools and optional runtime dependencies; does not include `docs` | qdk-chemistry[coverage,jupyter,networkx-extras,openfermion-extras,plugins,qiskit-extras,qre], nbclient, nbformat, pennylane, rdkit, requests>=2.33.0 |
-| `all` | Union of all defined extras | coverage, dev, docs, jupyter, networkx-extras, openfermion-extras, plugins, qiskit-extras, qre, test |
+| `test` | Testing tools and optional runtime dependencies; does not include `docs` | qdk-chemistry[coverage,jupyter,mcp,networkx-extras,openfermion-extras,plugins,qiskit-extras,qre], nbclient, nbformat, pennylane, rdkit, requests>=2.33.0 |
+| `all` | Union of all defined extras | coverage, dev, docs, jupyter, mcp, networkx-extras, openfermion-extras, plugins, qiskit-extras, qre, test |
 
 To build the documentation, install the `docs` extra (for example,
 `python3 -m pip install 'qdk-chemistry[docs]'`), install the Doxygen system
@@ -168,7 +170,7 @@ to native Windows installs; none of them apply under
 | Topic | Detail |
 |-------|--------|
 | PySCF plugin | PySCF publishes no Windows wheels, so the `plugins` extra installs no PySCF and the PySCF plugin is unavailable. The native implementations are unaffected. |
-| arm64 extras | Qiskit (and Qiskit Aer, Nature, IBM Runtime), PennyLane and RDKit are skipped on arm64: they require `rustworkx`, which publishes no win-arm64 wheels. The Discovery backend (`azure-ai-discovery`, `azure-identity`, `azure-storage-blob`) is skipped as well: it requires `cryptography`, which publishes no win-arm64 wheel and needs a Rust toolchain plus OpenSSL to build from source. The features that depend on them are unavailable; everything else is unaffected. |
+| arm64 dependencies and extras | MCP is omitted from the `all` and `test` extras because its `cryptography` dependency publishes no win-arm64 wheel. A base, `all`, or `test` install therefore needs neither Rust nor a source build of `cryptography`; installing the `mcp` extra explicitly may require an ARM64 Rust toolchain, MSVC C/C++ build tools, and ARM64 OpenSSL development libraries. Qiskit (and Qiskit Aer, Nature, IBM Runtime), PennyLane and RDKit are skipped because they require `rustworkx`, which also publishes no win-arm64 wheel. The Discovery backend (`azure-ai-discovery`, `azure-identity`, `azure-storage-blob`) is skipped as well. The features that depend on those skipped extras are unavailable. |
 | OpenMP | Shared-memory threading via OpenMP is disabled on Windows. |
 
 ---