ci: improve MCP publishing workflow and automate server.json updates

- Update publish workflow to trigger on Release completion
- Add workflow_dispatch for manual execution and safety checks
- Create update-server-json.js script to automate version and hash updates
- Integrate server.json updates into semantic-release process
- Include server.json in Git assets and GitHub release artifacts
- Improve workflow reliability with frozen lockfile and better triggers

Author: ahonn

.github/workflows/publish-mcp.yml

@@ -1,52 +1,50 @@
-name: Publish MCP Server
+name: Publish to MCP Registry
 
 on:
+  workflow_run:
+    workflows: ['Release']
+    types: [completed]
+    branches: [master]
+  workflow_dispatch: # Support manual execution
   push:
-    tags:
-      - 'v*.*.*'
+    tags: ['v*'] # Also triggers on version tags like v1.0.0
 
 permissions:
+  id-token: write # Required for OIDC authentication
   contents: read
-  id-token: write
 
 jobs:
   publish:
     runs-on: ubuntu-latest
+    # Only run if the Release workflow succeeded or if manually triggered
+    if: ${{ github.event_name == 'workflow_dispatch' || github.event_name == 'push' || github.event.workflow_run.conclusion == 'success' }}
 
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: '20'
-          registry-url: 'https://registry.npmjs.org'
 
       - name: Setup pnpm
         uses: pnpm/action-setup@v4
-        with:
-          version: 10.12.1
 
       - name: Install dependencies
-        run: pnpm install
+        run: pnpm install --frozen-lockfile
 
-      - name: Run linter
+      - name: Lint and format check
         run: pnpm run lint
 
-      - name: Build project
-        run: pnpm run build
-
-      - name: Publish to npm
-        run: pnpm publish --no-git-checks
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-      - name: Install MCP Publisher CLI
-        run: npm install -g @modelcontextprotocol/publisher
+      - name: Install MCP Publisher
+        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: Login to MCP Registry
-        run: mcp-publisher login github-oidc
+        run: ./mcp-publisher login github-oidc
 
       - name: Publish to MCP Registry
-        run: mcp-publisher publish
+        run: ./mcp-publisher publish

.releaserc.json

@@ -8,13 +8,18 @@
     [
       "@semantic-release/exec",
       {
-        "prepareCmd": "node scripts/sync-manifest-version.js && pnpm run dxt:pack && pnpm run mcpb:pack"
+        "prepareCmd": "node scripts/sync-manifest-version.js && pnpm run dxt:pack && pnpm run mcpb:pack && node scripts/update-server-json.js"
       }
     ],
     [
       "@semantic-release/git",
       {
-        "assets": ["CHANGELOG.md", "package.json", "manifest.json"],
+        "assets": [
+          "CHANGELOG.md",
+          "package.json",
+          "manifest.json",
+          "server.json"
+        ],
         "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
       }
     ],
@@ -31,6 +36,11 @@
             "path": "pageindex-mcp.mcpb",
             "name": "pageindex-mcp-${nextRelease.version}.mcpb",
             "label": "pageindex-mcp-${nextRelease.version}.mcpb"
+          },
+          {
+            "path": "server.json",
+            "name": "server.json",
+            "label": "server.json"
           }
         ]
       }

scripts/update-server-json.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+import { createHash } from 'node:crypto';
+import { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+
+function sha256OfFile(path) {
+  const buf = readFileSync(path);
+  return createHash('sha256').update(buf).digest('hex');
+}
+
+try {
+  const pkg = JSON.parse(readFileSync('package.json', 'utf8'));
+
+  // Find the .mcpb file
+  const mcpbFiles = readdirSync('.').filter((f) => f.endsWith('.mcpb'));
+  const mcpbFile = mcpbFiles[0] || 'pageindex-mcp.mcpb';
+
+  // Calculate hash if file exists
+  const hash = existsSync(mcpbFile) ? sha256OfFile(mcpbFile) : '';
+
+  const server = existsSync('server.json')
+    ? JSON.parse(readFileSync('server.json', 'utf8'))
+    : {};
+
+  // Update version
+  server.version = pkg.version;
+
+  // Update packages
+  if (server.packages && server.packages.length > 0) {
+    // Update npm package (first entry)
+    if (server.packages[0].registry_type === 'npm') {
+      server.packages[0].version = pkg.version;
+    }
+
+    // Update MCPB package (second entry)
+    if (
+      server.packages.length > 1 &&
+      server.packages[1].registry_type === 'mcpb'
+    ) {
+      server.packages[1].version = pkg.version;
+      server.packages[1].identifier = `https://github.com/VectifyAI/pageindex-mcp/releases/download/v${pkg.version}/pageindex-mcp-${pkg.version}.mcpb`;
+      server.packages[1].file_sha256 = hash;
+      server.packages[1].transport = {
+        type: 'stdio',
+      };
+    }
+  }
+
+  writeFileSync('server.json', `${JSON.stringify(server, null, 2)}\n`);
+  console.log('server.json updated:', {
+    version: pkg.version,
+    npm_package: server.packages?.[0]?.identifier,
+    mcpb_package: server.packages?.[1]?.identifier,
+    file_sha256: hash || '(hash will be calculated after mcpb build)',
+  });
+} catch (err) {
+  console.error('Failed to update server.json:', err.message);
+  process.exit(1);
+}

server.json

@@ -3,18 +3,26 @@
   "name": "io.github.vectifyai/pageindex-mcp",
   "title": "PageIndex MCP",
   "description": "MCP server for PageIndex - a reasoning-based RAG system for chatting with long PDFs. Supports local and online PDFs with unlimited conversations and free 1000 pages.",
-  "version": "1.5.0",
-  "homepage": "https://pageindex.ai/mcp",
+  "status": "active",
   "repository": {
-    "type": "git",
-    "url": "https://github.com/VectifyAI/pageindex-mcp"
+    "url": "https://github.com/VectifyAI/pageindex-mcp",
+    "source": "github"
   },
-  "license": "MIT",
+  "version": "1.5.0",
   "packages": [
     {
-      "registryType": "npm",
+      "registry_type": "npm",
+      "version": "1.5.0",
       "identifier": "pageindex-mcp",
+      "transport": {
+        "type": "stdio"
+      }
+    },
+    {
+      "registry_type": "mcpb",
       "version": "1.5.0",
+      "identifier": "https://github.com/VectifyAI/pageindex-mcp/releases/download/v1.5.0/pageindex-mcp-1.5.0.mcpb",
+      "file_sha256": "",
       "transport": {
         "type": "stdio"
       }