feat(mcp): migrate to mcp 2.x (MCPServer) (#10)

Co-authored-by: claude <[email protected]>

.gitea/workflows/refresh.yml

@@ -92,6 +92,9 @@ jobs:
           # out of requirements.txt so they never bloat the server image.
           python -m pip install -q -r requirements-vision.txt
 
+      - name: Smoke — server module imports
+        run: python -c "import docs_mcp.server"
+
       # ---- Phase 1: scrape ---------------------------------------
       - name: Refresh bundle catalog
         run: python -m scrape.bundles
@@ -221,6 +224,18 @@ jobs:
           tags: ${{ steps.meta.outputs.tags }}
           labels: ${{ steps.meta.outputs.labels }}
 
+      - name: Smoke — image must import docs_mcp.server
+        # mcp 2.x renamed mcp.server.fastmcp -> mcp.server.mcpserver, so an
+        # unpinned dep produced a green build that crash-looped in prod
+        # (seed-mcp 2026-09-01, zerto-docs 2026-08-11). Import is
+        # side-effect-free here (lazy singletons), so this needs no
+        # Ollama/Chroma.
+        if: steps.commit.outputs.changed == 'true' || inputs.force_build == true
+        run: |
+          IMAGE="${{ steps.repo.outputs.owner }}/${{ steps.repo.outputs.name }}"
+          docker run --rm --entrypoint python \
+            "${REGISTRY_PUSH}/${IMAGE}:latest" -c "import docs_mcp.server"
+
       - name: Link container package to this repo
         # Idempotent linkage so the package shows under the repo's
         # Packages tab. Gitea's auto-link from the source label is