laive-mcp 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## Unreleased
 
+## v0.1.2 - 2026-03-22
+
+- Fixed an MCP transport crash when the Live bridge socket is unreachable by preventing the bridge client from raising an unhandled `error` event during lazy connection attempts. Tool calls now return structured MCP errors instead of closing the server process.
+
+## v0.1.1 - 2026-03-22
+
+- Fixed MCP startup compatibility by implementing the `initialize` handshake, ignoring `notifications/initialized`, and deferring Live bridge connection until the first real tool call so the server can start before Ableton is reachable.
+
 ## v0.1.0 - 2026-03-22
 
 - Renamed the published npm package from `laive` to `laive-mcp` because `laive` is already taken on npm. The Ableton-side control surface name remains `laive`.
@@ -11,3 +19,4 @@
 - Added shipping and staging for the prebuilt `laive-sidecar.amxd` device.
 - Added `laive mcp-config` for local and published MCP client configuration output.
 - Added publish and release tooling, including `AGENTS.md`, `scripts/release.mjs`, and `scripts/version-workspaces.mjs`.
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "laive-mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Local MCP, install tooling, and helper assets for controlling Ableton Live.",
   "license": "GPL-3.0-only",
   "type": "module",
@@ -13,7 +13,9 @@
   "publishConfig": {
     "access": "public"
   },
-  "bin": "./bin/laive.mjs",
+  "bin": {
+    "laive-mcp": "bin/laive.mjs"
+  },
   "files": [
     "bin/",
     "README.md",

package/packages/live-bridge-remote-script/src/bridge/client.js

@@ -55,7 +55,11 @@ export class BridgeClient extends EventEmitter {
 
     this.socket.on("data", (chunk) => parser.push(Buffer.from(chunk)));
     this.socket.on("end", () => parser.end());
-    this.socket.on("error", (error) => this.emit("error", error));
+    this.socket.on("error", (error) => {
+      if (this.listenerCount("error") > 0) {
+        this.emit("error", error);
+      }
+    });
     this.socket.on("close", () => {
       this.socket = null;
       this.emit("close");

package/packages/mcp-server/src/cli.js

@@ -44,7 +44,7 @@ async function createSession(options) {
     return LaiveFixtureSession.create();
   }
 
-  return LaiveBridgeSession.connect({
+  return LaiveBridgeSession.createLazy({
     host: options.host,
     port: options.port
   });
@@ -55,7 +55,7 @@ async function main() {
   const session = await createSession(options);
   const server = new LaiveMcpServer({
     stateAdapter: createStateAdapter(session),
-    bridgeAdapter: createBridgeAdapter(session.bridgeClient),
+    bridgeAdapter: createBridgeAdapter(session),
       policyAdapter: createAllowAllPolicyAdapter()
   });
   let lineReader = null;
@@ -101,7 +101,9 @@ async function main() {
     }
 
     const response = await server.safeHandleRpcMessage(message);
-    process.stdout.write(`${JSON.stringify(response)}\n`);
+    if (response) {
+      process.stdout.write(`${JSON.stringify(response)}\n`);
+    }
   }
 
   await session.close();

package/packages/mcp-server/src/server.js

@@ -1,3 +1,4 @@
+import rootPackage from "../../../package.json" with { type: "json" };
 import { ToolRegistry } from "./tool-registry.js";
 import { buildDefaultTools } from "./default-tools.js";
 import { McpServerError, toErrorShape } from "./errors.js";
@@ -6,7 +7,7 @@ export class LaiveMcpServer {
   constructor({ stateAdapter, bridgeAdapter, policyAdapter, serverInfo } = {}) {
     this.serverInfo = serverInfo ?? {
       name: "laive-mcp",
-      version: "0.1.0"
+      version: rootPackage.version
     };
     this.stateAdapter = stateAdapter ?? createUnsupportedAdapter("state");
     this.bridgeAdapter = bridgeAdapter ?? createUnsupportedAdapter("bridge");
@@ -39,6 +40,39 @@ export class LaiveMcpServer {
       throw new McpServerError("invalid_request", "Message must be an object");
     }
 
+    if (message.method === "initialize") {
+      const requestedProtocolVersion =
+        typeof message.params?.protocolVersion === "string"
+          ? message.params.protocolVersion
+          : null;
+
+      return {
+        jsonrpc: "2.0",
+        id: message.id ?? null,
+        result: {
+          protocolVersion: requestedProtocolVersion ?? "2024-11-05",
+          capabilities: {
+            tools: {
+              listChanged: false
+            }
+          },
+          serverInfo: this.serverInfo
+        }
+      };
+    }
+
+    if (message.method === "ping") {
+      return {
+        jsonrpc: "2.0",
+        id: message.id ?? null,
+        result: {}
+      };
+    }
+
+    if (typeof message.method === "string" && message.method.startsWith("notifications/")) {
+      return null;
+    }
+
     if (message.method === "tools/list") {
       return {
         jsonrpc: "2.0",

package/packages/mcp-server/src/session.js

@@ -1,3 +1,4 @@
+import rootPackage from "../../../package.json" with { type: "json" };
 import {
   BridgeClient,
   BridgeServer,
@@ -60,7 +61,7 @@ function normalizeTrack(track) {
 function toRuntimeSnapshot({ liveVersion, capabilities, song, scenes, tracks }) {
   return {
     observed_at: new Date().toISOString(),
-    bridge_version: "0.1.0",
+    bridge_version: rootPackage.version,
     live_version: liveVersion,
     application: parseLiveVersion(liveVersion),
     song: {
@@ -157,12 +158,23 @@ export function createAllowAllPolicyAdapter() {
   };
 }
 
-export function createBridgeAdapter(bridgeClient) {
+async function resolveBridgeClient(target) {
+  if (target && typeof target.ensureConnected === "function") {
+    await target.ensureConnected();
+    return target.bridgeClient;
+  }
+
+  return target;
+}
+
+export function createBridgeAdapter(target) {
   return {
     async getCapabilities() {
+      const bridgeClient = await resolveBridgeClient(target);
       return (await bridgeClient.request("capabilities")).result;
     },
     async setTempo(tempo, options = {}) {
+      const bridgeClient = await resolveBridgeClient(target);
       return (
         await bridgeClient.request(
           "set",
@@ -173,6 +185,7 @@ export function createBridgeAdapter(bridgeClient) {
       ).result;
     },
     async createTrack(kind, options = {}) {
+      const bridgeClient = await resolveBridgeClient(target);
       const result = (
         await bridgeClient.request(
           "call",
@@ -188,6 +201,7 @@ export function createBridgeAdapter(bridgeClient) {
       };
     },
     async createClip(payload) {
+      const bridgeClient = await resolveBridgeClient(target);
       const result = (
         await bridgeClient.request(
           "call",
@@ -208,6 +222,7 @@ export function createBridgeAdapter(bridgeClient) {
       };
     },
     async setParameter(payload, options = {}) {
+      const bridgeClient = await resolveBridgeClient(target);
       const result = (
         await bridgeClient.request(
           "set",
@@ -246,6 +261,9 @@ export function createStateAdapter(session) {
 
   return {
     async getProjectSummary() {
+      if (typeof session.ensureConnected === "function") {
+        await session.ensureConnected();
+      }
       const summary = session.stateEngine.query.summarizeProject();
       return {
         ...summary,
@@ -254,6 +272,9 @@ export function createStateAdapter(session) {
       };
     },
     async getSelectedContext() {
+      if (typeof session.ensureConnected === "function") {
+        await session.ensureConnected();
+      }
       const context = session.stateEngine.query.getSelectedContext() ?? {};
       return {
         stateVersion: stateVersion(),
@@ -261,9 +282,15 @@ export function createStateAdapter(session) {
       };
     },
     async listTracks() {
+      if (typeof session.ensureConnected === "function") {
+        await session.ensureConnected();
+      }
       return trackList();
     },
     async getTrackDetails(target) {
+      if (typeof session.ensureConnected === "function") {
+        await session.ensureConnected();
+      }
       const track =
         session.stateEngine.getState().tracks[target] ?? session.stateEngine.query.findTrack(target);
 
@@ -280,6 +307,9 @@ export function createStateAdapter(session) {
       };
     },
     async getDeviceTree(trackId) {
+      if (typeof session.ensureConnected === "function") {
+        await session.ensureConnected();
+      }
       const details = session.stateEngine.query.getTrackDetails(trackId);
       if (!details) {
         throw new Error(`Track not found: ${trackId}`);
@@ -292,6 +322,9 @@ export function createStateAdapter(session) {
       };
     },
     async refreshState(target) {
+      if (typeof session.ensureConnected === "function") {
+        await session.ensureConnected();
+      }
       const previousStateVersion = stateVersion();
       await session.syncSnapshot();
       return {
@@ -338,6 +371,10 @@ export class LaiveBridgeSession {
     return session;
   }
 
+  static createLazy(options = {}) {
+    return new LaiveLazySession(options);
+  }
+
   async start() {
     this.bridgeClient.on("event", this.boundEventHandler);
     await Promise.all([
@@ -394,6 +431,58 @@ export class LaiveFixtureSession extends LaiveBridgeSession {
   }
 }
 
+export class LaiveLazySession {
+  constructor({
+    host = process.env.LAIVE_BRIDGE_HOST ?? "127.0.0.1",
+    port = Number.parseInt(process.env.LAIVE_BRIDGE_PORT ?? "7612", 10),
+    clientId = process.env.LAIVE_BRIDGE_CLIENT_ID ?? "laive-mcp-session",
+    socketFactory = null
+  } = {}) {
+    this.connectionOptions = {
+      host,
+      port,
+      clientId,
+      socketFactory
+    };
+    this.stateEngine = createStateEngine();
+    this.bridgeClient = null;
+    this.activeSession = null;
+    this.connectingPromise = null;
+  }
+
+  async ensureConnected() {
+    if (this.activeSession) {
+      return this.activeSession;
+    }
+
+    if (!this.connectingPromise) {
+      this.connectingPromise = LaiveBridgeSession.connect(this.connectionOptions)
+        .then((session) => {
+          this.activeSession = session;
+          this.bridgeClient = session.bridgeClient;
+          this.stateEngine = session.stateEngine;
+          return session;
+        })
+        .finally(() => {
+          this.connectingPromise = null;
+        });
+    }
+
+    return await this.connectingPromise;
+  }
+
+  async syncSnapshot() {
+    const session = await this.ensureConnected();
+    return await session.syncSnapshot();
+  }
+
+  async close() {
+    if (this.activeSession) {
+      await this.activeSession.close();
+    }
+  }
+}
+
 function createLoopbackSocketPair() {
   const serverSocket = new FakeSocket();
   const clientSocket = new FakeSocket();