feat: publish agent-comms to the MCP Registry

Author: Mearman

README.md

@@ -101,6 +101,8 @@ Add to your MCP server configuration:
 
 The generic MCP bridge works with any MCP client. Incoming messages are included in every tool response.
 
+This server is also published to the MCP Registry as `io.github.exadev/agent-comms`.
+
 ### Other harnesses
 
 ```bash

package.json

@@ -9,6 +9,7 @@
     "url": "git+https://github.com/ExaDev/agent-comms.git"
   },
   "homepage": "https://github.com/ExaDev/agent-comms#readme",
+  "mcpName": "io.github.exadev/agent-comms",
   "bugs": "https://github.com/ExaDev/agent-comms/issues",
   "license": "MIT",
   "keywords": [
@@ -45,6 +46,8 @@
   "scripts": {
     "prepare": "husky",
     "build": "tsc && printf '#!/usr/bin/env node\n' | cat - dist/cli.js > dist/cli.tmp && mv dist/cli.tmp dist/cli.js",
+    "generate:server-json": "tsx scripts/sync-release-metadata.ts",
+    "publish:mcp-registry": "tsx scripts/publish-mcp-registry.ts",
     "lint": "eslint .",
     "test": "node --test dist/test/**/*.test.js",
     "typecheck": "tsc --noEmit"

release.config.ts

@@ -46,8 +46,8 @@ const config: GlobalConfig = {
     [
       "@semantic-release/exec",
       {
-        prepareCmd:
-          "node -e \"const fs=require('fs');const pkg=JSON.parse(fs.readFileSync('package.json','utf8'));const p=JSON.parse(fs.readFileSync('.claude-plugin/plugin.json','utf8'));p.version=pkg.version;fs.writeFileSync('.claude-plugin/plugin.json',JSON.stringify(p,null,2)+'\\n')\"",
+        prepareCmd: "tsx scripts/sync-release-metadata.ts",
+        publishCmd: "tsx scripts/publish-mcp-registry.ts",
       },
     ],
     [
@@ -57,6 +57,7 @@ const config: GlobalConfig = {
           "package.json",
           "pnpm-lock.yaml",
           ".claude-plugin/plugin.json",
+          "server.json",
         ],
         message: "chore(release): v${nextRelease.version} [skip ci]",
       },

scripts/publish-mcp-registry.ts

@@ -0,0 +1,37 @@
+import { mkdtempSync, rmSync } from "node:fs";
+import path from "node:path";
+import { tmpdir } from "node:os";
+import { spawnSync } from "node:child_process";
+
+function run(command: string, args: string[]): void {
+  const result = spawnSync(command, args, { stdio: "inherit" });
+  if (result.status !== 0) {
+    throw new Error(`Command failed: ${command} ${args.join(" ")}`);
+  }
+}
+
+const os = process.platform;
+const arch = process.arch;
+
+let binaryArch: string;
+if (arch === "x64") {
+  binaryArch = "amd64";
+} else if (arch === "arm64") {
+  binaryArch = "arm64";
+} else {
+  throw new Error(`Unsupported architecture: ${arch}`);
+}
+
+const archiveUrl = `https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_${os}_${binaryArch}.tar.gz`;
+const tempDir = mkdtempSync(path.join(tmpdir(), "agent-comms-mcp-"));
+
+try {
+  run("bash", [
+    "-lc",
+    `curl -fsSL "${archiveUrl}" | tar -xzf - -C "${tempDir}" mcp-publisher`,
+  ]);
+  run(path.join(tempDir, "mcp-publisher"), ["login", "github-oidc"]);
+  run(path.join(tempDir, "mcp-publisher"), ["publish"]);
+} finally {
+  rmSync(tempDir, { recursive: true, force: true });
+}

scripts/sync-release-metadata.ts

@@ -0,0 +1,109 @@
+import { readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+
+type JsonObject = Record<string, unknown>;
+
+function isRecord(value: unknown): value is JsonObject {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+function isUnknownArray(value: unknown): value is readonly unknown[] {
+  return Array.isArray(value);
+}
+
+function parseJsonObject(text: string, label: string): JsonObject {
+  const parsed: unknown = JSON.parse(text);
+  if (!isRecord(parsed)) {
+    throw new Error(`${label} must contain a JSON object`);
+  }
+  return parsed;
+}
+
+function requireString(value: unknown, label: string): string {
+  if (typeof value !== "string") {
+    throw new Error(`${label} must be a string`);
+  }
+  return value;
+}
+
+function stringifyJson(value: JsonObject): string {
+  return `${JSON.stringify(value, null, 2)}\n`;
+}
+
+const root = process.cwd();
+const packagePath = path.join(root, "package.json");
+const pluginPath = path.join(root, ".claude-plugin/plugin.json");
+const serverPath = path.join(root, "server.json");
+
+const packageObject = parseJsonObject(
+  await readFile(packagePath, "utf8"),
+  "package.json",
+);
+const pluginObject = parseJsonObject(
+  await readFile(pluginPath, "utf8"),
+  ".claude-plugin/plugin.json",
+);
+const serverObject = parseJsonObject(
+  await readFile(serverPath, "utf8"),
+  "server.json",
+);
+
+const packageVersion = requireString(
+  packageObject.version,
+  "package.json version",
+);
+const mcpName = requireString(packageObject.mcpName, "package.json mcpName");
+const packageName = requireString(packageObject.name, "package.json name");
+const serverName = requireString(serverObject.name, "server.json name");
+const serverVersion = requireString(
+  serverObject.version,
+  "server.json version",
+);
+const pluginVersion = requireString(
+  pluginObject.version,
+  ".claude-plugin/plugin.json version",
+);
+
+if (serverName !== mcpName) {
+  throw new Error(
+    `server.json name (${serverName}) must match package.json mcpName (${mcpName})`,
+  );
+}
+
+const packagesValue = serverObject.packages;
+if (!isUnknownArray(packagesValue) || packagesValue.length !== 1) {
+  throw new Error("server.json must define exactly one package entry");
+}
+
+const packageEntryValue = packagesValue[0];
+if (!isRecord(packageEntryValue)) {
+  throw new Error("server.json package entry must be an object");
+}
+
+const registryType = requireString(
+  packageEntryValue.registryType,
+  "server.json package entry registryType",
+);
+const identifier = requireString(
+  packageEntryValue.identifier,
+  "server.json package entry identifier",
+);
+
+if (registryType !== "npm") {
+  throw new Error('server.json package entry must use registryType="npm"');
+}
+
+if (identifier !== packageName) {
+  throw new Error(
+    `server.json package identifier (${identifier}) must match package.json name (${packageName})`,
+  );
+}
+
+serverObject.version = packageVersion;
+packageEntryValue.version = packageVersion;
+pluginObject.version = packageVersion;
+
+if (serverVersion !== packageVersion || pluginVersion !== packageVersion) {
+  await writeFile(serverPath, stringifyJson(serverObject));
+  await writeFile(pluginPath, stringifyJson(pluginObject));
+}

server.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.exadev/agent-comms",
+  "title": "Agent Comms",
+  "description": "Cross-harness communication mesh for LLM agents — rooms, DMs, presence, and visibility over TCP",
+  "repository": {
+    "url": "https://github.com/ExaDev/agent-comms",
+    "source": "github"
+  },
+  "version": "1.8.2",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "agent-comms",
+      "version": "1.8.2",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}