c64bridge 0.8.0 → 0.8.1

package/doc/developer.md

@@ -119,8 +119,16 @@ Environment knobs: `RAG_EMBEDDINGS_DIR`, `RAG_BUILD_ON_START`, `RAG_REINDEX_INTE
 
 - `./build check` — build + test matrix in one pass
 - `./build changelog` — update CHANGELOG draft
-- `./build release --version <version>` — bump version, regenerate manifest, prepend changelog notes
-- Published package ships [`dist/`](../dist/), [`doc/`](../doc/), [`data/`](../data/), [`scripts/`](../scripts/), [`generated/`](../generated/), and [`mcp.json`](../mcp.json)
+- `./build release --version <version>` — bump version, refresh [`mcp.json`](../mcp.json) and [`server.json`](../server.json), prepend changelog notes
+- Published package ships [`dist/`](../dist/), [`doc/`](../doc/), [`data/`](../data/), [`scripts/`](../scripts/), [`generated/`](../generated/), [`mcp.json`](../mcp.json), and [`server.json`](../server.json)
+
+Tagging a release through the GitHub release UI triggers [`.github/workflows/release.yaml`](../.github/workflows/release.yaml), which publishes the npm package and then publishes the same version to the MCP Registry.
+
+- Required GitHub secret: `NPM_TOKEN`
+- No dedicated MCP Registry secret is required for the GitHub-driven flow; the workflow uses `mcp-publisher login github-oidc`
+- The release workflow must grant `id-token: write` so GitHub Actions can mint the short-lived OIDC token used by `mcp-publisher`
+- Keep [`package.json`](../package.json) `mcpName` aligned with [`server.json`](../server.json) `name`
+- The root [`server.json`](../server.json) is the MCP Registry manifest; [`mcp/server.json`](../mcp/server.json) remains generated MCP interface output
 
 ## 9. Troubleshooting Cheatsheet
 

package/mcp/server.json

@@ -1,6 +1,6 @@
 {
   "name": "c64bridge",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Stdio-based Model Context Protocol (MCP) server that bridges Commodore 64 Ultimate hardware with AI agents.",
   "transports": [
     "stdio"

package/mcp.json

@@ -1,6 +1,6 @@
 {
   "name": "c64bridge",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Stdio-based Model Context Protocol (MCP) server that bridges Commodore 64 Ultimate hardware with AI agents.",
   "entry": "dist/index.js",
   "type": "stdio",
@@ -9,11 +9,14 @@
     "mcp-server",
     "model context protocol",
     "openai",
-    "ultimate64",
-    "commodore64",
-    "commodore 64",
+    "commodore",
     "c64",
     "c64u",
+    "commodore64",
+    "commodore 64",
+    "commodore 64 ultimate",
+    "ultimate64",
+    "ultimate 64",
     "sid",
     "basic",
     "assembly",
@@ -22,9 +25,7 @@
     "retrogaming",
     "vintage computing",
     "hardware integration",
-    "c64 development",
-    "commodore 64 ultimate",
-    "ultimate 64"
+    "c64 development"
   ],
   "env": {
     "LOG_LEVEL": {

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "c64bridge",
-  "version": "0.8.0",
-  "description": "Local MCP server for controlling a Commodore 64 via Ultimate 64 REST API",
+  "version": "0.8.1",
+  "mcpName": "io.github.chrisgleissner/c64bridge",
+  "description": "C64 Bridge MCP server for Commodore 64 Ultimate hardware and VICE emulator control",
   "type": "module",
   "main": "dist/index.js",
   "packageManager": "bun@1.3.1",
@@ -79,6 +80,7 @@
   },
   "files": [
     "mcp.json",
+    "server.json",
     "AGENTS.md",
     "LICENSE",
     "README.md",

package/scripts/prepare-release.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { execSync } from 'node:child_process';
-import { readFile, writeFile } from 'node:fs/promises';
+import { access, readFile, writeFile } from 'node:fs/promises';
 import path from 'node:path';
 import process from 'node:process';
 
@@ -16,6 +16,27 @@ const updateJsonFile = async (relativePath, updater) => {
   await writeFile(filePath, JSON.stringify(updated, null, 2) + '\n');
 };
 
+const fileExists = async (relativePath) => {
+  try {
+    await access(path.resolve(relativePath));
+    return true;
+  } catch {
+    return false;
+  }
+};
+
+const getRepositoryMetadata = (repository) => {
+  const url = typeof repository === 'string' ? repository : repository?.url;
+  if (!url) {
+    return undefined;
+  }
+
+  return {
+    url,
+    source: url.includes('github.com') ? 'github' : undefined,
+  };
+};
+
 const normaliseVersion = (value) => value.replace(/^v/, '');
 
 const isExactVersion = (value) => /^v?\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/.test(value);
@@ -72,6 +93,42 @@ await updateJsonFile('mcp.json', async (data) => ({
   version: newVersion,
 }));
 
+if (await fileExists('server.json')) {
+  await updateJsonFile('server.json', async (data) => {
+    const packages = Array.isArray(data.packages) ? [...data.packages] : [];
+    const primaryPackage = packages[0] ?? {
+      registryType: 'npm',
+      transport: {
+        type: 'stdio',
+      },
+    };
+
+    packages[0] = {
+      ...primaryPackage,
+      identifier: pkg.name,
+      version: newVersion,
+      transport: primaryPackage.transport ?? {
+        type: 'stdio',
+      },
+    };
+
+    const repository = getRepositoryMetadata(pkg.repository);
+
+    return {
+      ...data,
+      name: pkg.mcpName ?? data.name,
+      version: newVersion,
+      repository: repository
+        ? {
+            ...(data.repository ?? {}),
+            ...repository,
+          }
+        : data.repository,
+      packages,
+    };
+  });
+}
+
 // Manifest generation removed (runtime discovery via MCP stdio)
 
 // Update CHANGELOG.md from commits since last tag using Conventional Commits subjects.
@@ -88,4 +145,4 @@ if (skippedVersionBump && hasExistingChangelogEntry) {
 }
 
 console.log(`Release metadata updated to ${newVersion}.`);
-console.log('Next steps: commit the changes, open a PR, and tag the merged commit.');
+console.log('Next steps: commit and push the changes, then create the release tag from GitHub once main is ready.');

package/server.json

@@ -0,0 +1,94 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.chrisgleissner/c64bridge",
+  "title": "C64 Bridge",
+  "description": "MCP server for Commodore 64 Ultimate hardware and VICE emulator control.",
+  "repository": {
+    "url": "https://github.com/chrisgleissner/c64bridge",
+    "source": "github"
+  },
+  "websiteUrl": "https://github.com/chrisgleissner/c64bridge",
+  "version": "0.8.1",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "c64bridge",
+      "version": "0.8.1",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "LOG_LEVEL",
+          "description": "Logger verbosity.",
+          "format": "string",
+          "default": "info",
+          "choices": [
+            "debug",
+            "info",
+            "warn",
+            "error"
+          ]
+        },
+        {
+          "name": "C64BRIDGE_CONFIG",
+          "description": "Path to the C64 Bridge configuration file.",
+          "format": "filepath",
+          "default": "~/.c64bridge.json"
+        },
+        {
+          "name": "C64_MODE",
+          "description": "Active backend.",
+          "format": "string",
+          "default": "c64u",
+          "choices": [
+            "c64u",
+            "vice"
+          ]
+        },
+        {
+          "name": "C64U_HOST",
+          "description": "Ultimate 64 host name or IP address.",
+          "format": "string",
+          "default": "c64u"
+        },
+        {
+          "name": "C64U_PORT",
+          "description": "Ultimate 64 REST port.",
+          "format": "number",
+          "default": "80"
+        },
+        {
+          "name": "C64U_PASSWORD",
+          "description": "Ultimate 64 network password sent as X-Password.",
+          "format": "string",
+          "isSecret": true
+        },
+        {
+          "name": "VICE_BINARY",
+          "description": "VICE emulator binary to launch.",
+          "format": "string",
+          "default": "x64sc"
+        },
+        {
+          "name": "VICE_VISIBLE",
+          "description": "Launch VICE with a visible window when possible.",
+          "format": "boolean",
+          "default": "true"
+        },
+        {
+          "name": "VICE_WARP",
+          "description": "Enable VICE warp mode.",
+          "format": "boolean",
+          "default": "false"
+        },
+        {
+          "name": "GITHUB_TOKEN",
+          "description": "GitHub token for optional RAG discovery against GitHub.",
+          "format": "string",
+          "isSecret": true
+        }
+      ]
+    }
+  ]
+}