ci: add manual 'Release E2E' workflow; enhance MCP Registry publish/verify; add OCI label and PyPI marker

mcp-release-bot · mcp-release-bot · commit c8e7040d8155 · 2025-09-18T01:37:23.000+03:00
diff --git a/.github/workflows/release-e2e.yml b/.github/workflows/release-e2e.yml
@@ -0,0 +1,97 @@
+name: Release E2E
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "Semantic version (e.g., 0.3.0)"
+        required: true
+        type: string
+
+env:
+  PYTHON_VERSION: "3.13"
+
+jobs:
+  prepare_and_push:
+    name: Bump, commit, tag, and push (main)
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          version: latest
+
+      - name: Set up Python
+        run: uv python install ${{ env.PYTHON_VERSION }}
+
+      - name: Validate input version and tag uniqueness
+        id: validate
+        run: |
+          set -euo pipefail
+          VERSION="${{ inputs.version }}"
+          if ! echo "$VERSION" | grep -Eq '^[0-9]+\.[0-9]+\.[0-9]+$'; then
+            echo "Invalid version format: $VERSION (expected MAJOR.MINOR.PATCH)" >&2
+            exit 1
+          fi
+          if git rev-parse "v$VERSION" >/dev/null 2>&1; then
+            echo "Tag v$VERSION already exists locally" >&2
+            exit 1
+          fi
+          echo "VERSION=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Bump version in files
+        run: |
+          uv run python scripts/bump_version.py --version "${{ steps.validate.outputs.VERSION }}" | tee bump.log
+
+      - name: Create GitHub App token
+        id: app_token
+        uses: actions/create-github-app-token@v1
+        with:
+          app-id: ${{ secrets.APP_ID }}
+          private-key: ${{ secrets.APP_PRIVATE_KEY }}
+
+      - name: Configure git user
+        run: |
+          git config user.name "mcp-release-bot"
+          git config user.email "mcp-release-bot@users.noreply.github.com"
+
+      - name: Ensure on main branch
+        run: |
+          git fetch origin main --tags
+          git checkout main
+
+      - name: Commit changes (if any)
+        run: |
+          set -e
+          if git diff --quiet; then
+            echo "No working tree changes to commit."
+          else
+            git add -A
+            git commit -m "chore(release): bump version to ${{ steps.validate.outputs.VERSION }}"
+          fi
+
+      - name: Create tag
+        run: |
+          git tag "v${{ steps.validate.outputs.VERSION }}"
+
+      - name: Push commit and tag to origin/main
+        env:
+          GH_TOKEN: ${{ steps.app_token.outputs.token }}
+        run: |
+          set -e
+          git remote set-url origin "https://x-access-token:${GH_TOKEN}@github.com/${{ github.repository }}.git"
+          git push origin HEAD:main
+          git push origin "v${{ steps.validate.outputs.VERSION }}"
+
+      - name: Summary
+        run: echo "Pushed commit and tag v${{ steps.validate.outputs.VERSION }}. The Release workflow will run automatically."
+
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -139,17 +139,69 @@ jobs:
 
   publish_mcp_registry:
     name: Publish to MCP Registry (preview)
-    runs-on: macos-latest
+    runs-on: ubuntu-latest
     permissions:
       contents: read
+      id-token: write
     continue-on-error: true
     steps:
       - uses: actions/checkout@v5
       - name: Install MCP Publisher CLI
-        run: brew install mcp-publisher
-      - name: Initialize server metadata (idempotent)
-        run: mcp-publisher init || true
+        run: |
+          curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v1.0.0/mcp-publisher_1.0.0_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
+      - name: Extract version from tag
+        id: ver
+        run: |
+          echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
+      - name: Generate server.json
+        env:
+          VERSION: ${{ steps.ver.outputs.VERSION }}
+        run: |
+          python - <<'PY'
+          import json, tomllib, os
+          VERSION = os.environ['VERSION']
+          with open('pyproject.toml','rb') as f:
+              proj = tomllib.load(f)['project']
+          desc = proj.get('description','')
+          data = {
+            "$schema": "https://static.modelcontextprotocol.io/schemas/2025-07-09/server.schema.json",
+            "name": "io.github.othervibes/mcp-as-a-judge",
+            "description": desc,
+            "version": VERSION,
+            "packages": [
+              {"registry_type": "pypi", "identifier": "mcp-as-a-judge", "version": VERSION},
+              {"registry_type": "oci", "registry_base_url": "https://ghcr.io", "identifier": "othervibes/mcp-as-a-judge", "version": VERSION}
+            ]
+          }
+          with open('server.json','w') as f: json.dump(data,f,indent=2)
+          PY
+      - name: Login to MCP Registry (GitHub OIDC)
+        run: ./mcp-publisher login github-oidc
       - name: Publish to MCP Registry
+        run: ./mcp-publisher publish
+      - name: Verify publication
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: mcp-publisher publish
+          NAME: io.github.othervibes/mcp-as-a-judge
+        run: |
+          for i in {1..10}; do
+            sleep 3
+            curl -sf "https://registry.modelcontextprotocol.io/v0/servers?search=$NAME" -o out.json || true
+            python - <<'PY'
+          import json, sys, os
+          name = os.environ['NAME']
+          try:
+              data=json.load(open('out.json'))
+          except Exception:
+              sys.exit(1)
+          items = []
+          if isinstance(data, dict):
+              items = data.get('results') or data.get('servers') or data.get('data') or []
+          elif isinstance(data, list):
+              items = data
+          ok = any(isinstance(s, dict) and s.get('name') == name for s in items)
+          sys.exit(0 if ok else 1)
+          PY
+            if [ $? -eq 0 ]; then echo "Verified $NAME in registry"; exit 0; fi
+          done
+          echo "Server not visible in registry yet"
+          exit 1
diff --git a/Dockerfile b/Dockerfile
@@ -76,7 +76,8 @@ HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
 CMD ["mcp-as-a-judge"]
 
 # Labels for metadata
-LABEL org.opencontainers.image.title="MCP as a Judge" \
+LABEL io.modelcontextprotocol.server.name="io.github.othervibes/mcp-as-a-judge" \
+      org.opencontainers.image.title="MCP as a Judge" \
       org.opencontainers.image.description="AI-powered code evaluation and software engineering best practices enforcement" \
       org.opencontainers.image.version="${VERSION}" \
       org.opencontainers.image.authors="Zvi Fried" \
diff --git a/README.md b/README.md
@@ -1,5 +1,7 @@
 # MCP as a Judge ⚖️
 
+<!-- mcp-name: io.github.othervibes/mcp-as-a-judge -->
+
 <div align="left">
   <img src="assets/mcp-as-a-judge.png" alt="MCP as a Judge Logo" width="200">
 </div>
@@ -103,6 +105,16 @@ Configure **MCP as a Judge** in your MCP-enabled client:
 
 ### **Method 1: Using Docker (Recommended)**
 
+#### One‑click install for VS Code (MCP)
+
+Add this server to VS Code (GitHub Copilot) using Docker with automatic image pull:
+
+- Install link: https://insiders.vscode.dev/redirect/mcp/install?name=mcp-as-a-judge&inputs=%5B%5D&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22--pull%3Dalways%22%2C%22ghcr.io%2Fothervibes%2Fmcp-as-a-judge%3Alatest%22%5D%7D
+
+Notes:
+- VS Code controls the sampling model; select it via “MCP: List Servers → mcp-as-a-judge → Configure Model Access”.
+
+
 1. **Configure MCP Settings:**
 
    Add this to your MCP client configuration file:
