x-m32-mcp-server 2.1.0

package/dist/esm/tools/connect.tool.js

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+/**
+ * Register x32_connect tool
+ * Establishes connection to X32/M32 mixer
+ */
+export function registerConnectTool(server, connection) {
+    server.tool('x32_connect', 'Establishes a connection to an X32 or M32 digital mixing console using the OSC (Open Sound Control) protocol. Use this tool when you need to control mixer functions remotely. The mixer must be powered on and connected to the same network.', {
+        host: z.string().describe('IP address of the X32/M32 mixer on the network (e.g., "192.168.1.100")'),
+        port: z.number().default(10023).describe('OSC port number for communication with the mixer (standard port is 10023)')
+    }, {
+        title: 'Connect to X32/M32 Mixer',
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+    }, async ({ host, port }) => {
+        if (connection.connected) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Already connected to X32/M32 mixer'
+                    }
+                ]
+            };
+        }
+        try {
+            await connection.connect({ host, port });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Successfully connected to X32/M32 at ${host}:${port}`
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Connection to X32/M32 mixer failed: ${error instanceof Error ? error.message : String(error)}. Please verify the mixer is powered on, connected to the network, and the IP address is correct. Check that port ${port} is not blocked by firewall.`
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+}
+//# sourceMappingURL=connect.tool.js.map

package/dist/esm/tools/connect.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.tool.js","sourceRoot":"","sources":["../../../src/tools/connect.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,UAAyB;IACzE,MAAM,CAAC,IAAI,CACP,aAAa,EACb,gPAAgP,EAChP;QACI,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wEAAwE,CAAC;QACnG,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,2EAA2E,CAAC;KACxH,EACD;QACI,KAAK,EAAE,0BAA0B;QACjC,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACtB,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAA2B,EAAE;QAC9C,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;YACvB,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,oCAAoC;qBAC7C;iBACJ;aACJ,CAAC;QACN,CAAC;QAED,IAAI,CAAC;YACD,MAAM,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACzC,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,wCAAwC,IAAI,IAAI,IAAI,EAAE;qBAC/D;iBACJ;aACJ,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,uCAAuC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,qHAAqH,IAAI,8BAA8B;qBAC7P;iBACJ;gBACD,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/esm/tools/connection.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { X32Connection } from '../services/x32-connection.js';
+/**
+ * Register all connection domain tools
+ */
+export declare function registerConnectionTools(server: McpServer, connection: X32Connection): void;
+//# sourceMappingURL=connection.d.ts.map

package/dist/esm/tools/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../src/tools/connection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAuP9D;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,GAAG,IAAI,CAK1F"}

package/dist/esm/tools/connection.js

@@ -0,0 +1,227 @@
+import { z } from 'zod';
+/**
+ * Connection domain tools
+ * Handles connection, disconnection, info, and status operations
+ */
+/**
+ * Register connection_connect tool
+ * Establishes connection to X32/M32 mixer
+ */
+function registerConnectionConnectTool(server, connection) {
+    server.registerTool('connection_connect', {
+        title: 'Connect to X32/M32 Mixer',
+        description: 'Establishes a connection to an X32 or M32 digital mixing console using the OSC (Open Sound Control) protocol. Use this tool when you need to control mixer functions remotely. The mixer must be powered on and connected to the same network.',
+        inputSchema: {
+            host: z.string().describe('IP address of the X32/M32 mixer on the network (e.g., "192.168.1.100")'),
+            port: z.number().default(10023).describe('OSC port number for communication with the mixer (standard port is 10023)')
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async ({ host, port }) => {
+        if (connection.connected) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Already connected to X32/M32 mixer'
+                    }
+                ]
+            };
+        }
+        try {
+            await connection.connect({ host, port });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Successfully connected to X32/M32 at ${host}:${port}`
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Connection to X32/M32 mixer failed: ${error instanceof Error ? error.message : String(error)}. Please verify the mixer is powered on, connected to the network, and the IP address is correct. Check that port ${port} is not blocked by firewall.`
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+}
+/**
+ * Register connection_disconnect tool
+ * Disconnects from X32/M32 mixer
+ */
+function registerConnectionDisconnectTool(server, connection) {
+    server.registerTool('connection_disconnect', {
+        title: 'Disconnect from X32/M32 Mixer',
+        description: 'Disconnects from the currently connected X32 or M32 digital mixing console. Use this tool to cleanly terminate the OSC connection when mixer control is no longer needed.',
+        inputSchema: {},
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async () => {
+        if (!connection.connected) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Not connected to X32/M32 mixer'
+                    }
+                ]
+            };
+        }
+        try {
+            await connection.disconnect();
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Successfully disconnected from X32/M32 mixer'
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to disconnect: ${error instanceof Error ? error.message : String(error)}`
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+}
+/**
+ * Register connection_get_info tool
+ * Retrieves console information from X32/M32 mixer
+ */
+function registerConnectionGetInfoTool(server, connection) {
+    server.registerTool('connection_get_info', {
+        title: 'Get X32/M32 Console Information',
+        description: 'Retrieves detailed console information from connected X32 or M32 digital mixing console. Returns model name, firmware version, server details, and other system information useful for identifying mixer capabilities and troubleshooting.',
+        inputSchema: {},
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async () => {
+        if (!connection.connected) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Not connected to X32/M32 mixer. Use connection_connect first.'
+                    }
+                ],
+                isError: true
+            };
+        }
+        try {
+            const info = await connection.getInfo();
+            const output = [
+                `Console Model: ${info.consoleModel}`,
+                `Console Version: ${info.consoleVersion}`,
+                `McpServer Name: ${info.serverName}`,
+                `McpServer Version: ${info.serverVersion}`
+            ].join('\n');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: output
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to get info: ${error instanceof Error ? error.message : String(error)}`
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+}
+/**
+ * Register connection_get_status tool
+ * Retrieves current status from X32/M32 mixer
+ */
+function registerConnectionGetStatusTool(server, connection) {
+    server.registerTool('connection_get_status', {
+        title: 'Get X32/M32 Connection Status',
+        description: 'Retrieves the current operational status of the connected X32 or M32 digital mixing console. Returns connection state, network information, and server details to monitor mixer availability and network configuration.',
+        inputSchema: {},
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async () => {
+        if (!connection.connected) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Not connected to X32/M32 mixer. Use connection_connect first.'
+                    }
+                ],
+                isError: true
+            };
+        }
+        try {
+            const status = await connection.getStatus();
+            const output = [`State: ${status.state}`, `IP Address: ${status.ipAddress}`, `McpServer Name: ${status.serverName}`].join('\n');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: output
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to get status: ${error instanceof Error ? error.message : String(error)}`
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+}
+/**
+ * Register all connection domain tools
+ */
+export function registerConnectionTools(server, connection) {
+    registerConnectionConnectTool(server, connection);
+    registerConnectionDisconnectTool(server, connection);
+    registerConnectionGetInfoTool(server, connection);
+    registerConnectionGetStatusTool(server, connection);
+}
+//# sourceMappingURL=connection.js.map

package/dist/esm/tools/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../../src/tools/connection.ts"],"names":[],"mappings":"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"}

package/dist/esm/tools/get-parameter.tool.d.ts

@@ -0,0 +1,8 @@
+import { Server } from '../server.js';
+import { X32Connection } from '../services/x32-connection.js';
+/**
+ * Register x32_get_parameter tool
+ * Gets parameter value by OSC address pattern
+ */
+export declare function registerGetParameterTool(server: Server, connection: X32Connection): void;
+//# sourceMappingURL=get-parameter.tool.d.ts.map

package/dist/esm/tools/get-parameter.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-parameter.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/get-parameter.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,GAAG,IAAI,CAkDxF"}

package/dist/esm/tools/get-parameter.tool.js

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+/**
+ * Register x32_get_parameter tool
+ * Gets parameter value by OSC address pattern
+ */
+export function registerGetParameterTool(server, connection) {
+    server.tool('x32_get_parameter', 'Retrieves current parameter values from X32/M32 mixer using OSC address patterns. Use this tool to read fader positions, EQ settings, effects parameters, routing configurations, and other mixer state information for monitoring or automation purposes.', {
+        address: z.string().describe('OSC address pattern for the parameter to read (e.g., "/ch/01/mix/fader" for channel 1 fader level, "/main/st/mix/fader" for main stereo fader, "/ch/01/eq/1/f" for channel 1 EQ band 1 frequency)')
+    }, {
+        title: 'X32 Get Parameter',
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+    }, async ({ address }) => {
+        if (!connection.connected) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Not connected to X32/M32 mixer. Use x32_connect first.'
+                    }
+                ],
+                isError: true
+            };
+        }
+        try {
+            const value = await connection.getParameter(address);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `${address} = ${JSON.stringify(value)}`
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to get parameter: ${error instanceof Error ? error.message : String(error)}`
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+}
+//# sourceMappingURL=get-parameter.tool.js.map

package/dist/esm/tools/get-parameter.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-parameter.tool.js","sourceRoot":"","sources":["../../../src/tools/get-parameter.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAc,EAAE,UAAyB;IAC9E,MAAM,CAAC,IAAI,CACP,mBAAmB,EACnB,4PAA4P,EAC5P;QACI,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mMAAmM,CAAC;KACpO,EACD;QACI,KAAK,EAAE,mBAAmB;QAC1B,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACtB,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAA2B,EAAE;QAC3C,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;YACxB,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,wDAAwD;qBACjE;iBACJ;gBACD,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;QAED,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YACrD,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,GAAG,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;qBAChD;iBACJ;aACJ,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,4BAA4B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBAC7F;iBACJ;gBACD,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/esm/tools/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * X32 MCP Tools
+ * Export all tool registration functions organized by domain
+ */
+export { registerConnectionTools } from './connection.js';
+export { registerChannelTools } from './channel.js';
+export { registerParameterTools } from './parameter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/esm/tools/index.js

@@ -0,0 +1,8 @@
+/**
+ * X32 MCP Tools
+ * Export all tool registration functions organized by domain
+ */
+export { registerConnectionTools } from './connection.js';
+export { registerChannelTools } from './channel.js';
+export { registerParameterTools } from './parameter.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/esm/tools/info.tool.d.ts

@@ -0,0 +1,8 @@
+import { Server } from '../server.js';
+import { X32Connection } from '../services/x32-connection.js';
+/**
+ * Register x32_get_info tool
+ * Retrieves console information from X32/M32 mixer
+ */
+export declare function registerInfoTool(server: Server, connection: X32Connection): void;
+//# sourceMappingURL=info.tool.d.ts.map

package/dist/esm/tools/info.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/info.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,GAAG,IAAI,CAuDhF"}

package/dist/esm/tools/info.tool.js

@@ -0,0 +1,54 @@
+/**
+ * Register x32_get_info tool
+ * Retrieves console information from X32/M32 mixer
+ */
+export function registerInfoTool(server, connection) {
+    server.tool('x32_get_info', 'Retrieves detailed console information from connected X32 or M32 digital mixing console. Returns model name, firmware version, server details, and other system information useful for identifying mixer capabilities and troubleshooting.', {}, {
+        title: 'X32 Get Info',
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+    }, async () => {
+        if (!connection.connected) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Not connected to X32/M32 mixer. Use x32_connect first.'
+                    }
+                ],
+                isError: true
+            };
+        }
+        try {
+            const info = await connection.getInfo();
+            const output = [
+                `Console Model: ${info.consoleModel}`,
+                `Console Version: ${info.consoleVersion}`,
+                `Server Name: ${info.serverName}`,
+                `Server Version: ${info.serverVersion}`
+            ].join('\n');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: output
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to get info: ${error instanceof Error ? error.message : String(error)}`
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+}
+//# sourceMappingURL=info.tool.js.map

package/dist/esm/tools/info.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.tool.js","sourceRoot":"","sources":["../../../src/tools/info.tool.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,UAAyB;IACtE,MAAM,CAAC,IAAI,CACP,cAAc,EACd,4OAA4O,EAC5O,EAAE,EACF;QACI,KAAK,EAAE,cAAc;QACrB,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACtB,EACD,KAAK,IAA6B,EAAE;QAChC,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;YACxB,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,wDAAwD;qBACjE;iBACJ;gBACD,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;QAED,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;YACxC,MAAM,MAAM,GAAG;gBACX,kBAAkB,IAAI,CAAC,YAAY,EAAE;gBACrC,oBAAoB,IAAI,CAAC,cAAc,EAAE;gBACzC,gBAAgB,IAAI,CAAC,UAAU,EAAE;gBACjC,mBAAmB,IAAI,CAAC,aAAa,EAAE;aAC1C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEb,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,MAAM;qBACf;iBACJ;aACJ,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,uBAAuB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBACxF;iBACJ;gBACD,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/esm/tools/parameter.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { X32Connection } from '../services/x32-connection.js';
+/**
+ * Register all generic parameter tools
+ */
+export declare function registerParameterTools(server: McpServer, connection: X32Connection): void;
+//# sourceMappingURL=parameter.d.ts.map

package/dist/esm/tools/parameter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter.d.ts","sourceRoot":"","sources":["../../../src/tools/parameter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAwI9D;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,GAAG,IAAI,CAGzF"}

package/dist/esm/tools/parameter.js

@@ -0,0 +1,126 @@
+import { z } from 'zod';
+/**
+ * Generic parameter tools
+ * Low-level fallback tools for advanced users
+ */
+/**
+ * Register get_parameter tool
+ * Gets parameter value by OSC address pattern
+ */
+function registerGetParameterTool(server, connection) {
+    server.registerTool('get_parameter', {
+        title: 'Get Parameter (Low-Level)',
+        description: 'ADVANCED/LOW-LEVEL TOOL: Retrieves current parameter values from X32/M32 mixer using raw OSC address patterns. Consider using semantic tools (channel_*, bus_*, etc.) for common operations. Use this tool for parameters not covered by semantic tools or for debugging purposes.',
+        inputSchema: {
+            address: z
+                .string()
+                .describe('OSC address pattern for the parameter to read (e.g., "/ch/01/mix/fader" for channel 1 fader level, "/main/st/mix/fader" for main stereo fader, "/ch/01/eq/1/f" for channel 1 EQ band 1 frequency)')
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async ({ address }) => {
+        if (!connection.connected) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Not connected to X32/M32 mixer. Use connection_connect first.'
+                    }
+                ],
+                isError: true
+            };
+        }
+        try {
+            const value = await connection.getParameter(address);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `${address} = ${JSON.stringify(value)}`
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to get parameter: ${error instanceof Error ? error.message : String(error)}`
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+}
+/**
+ * Register set_parameter tool
+ * Sets parameter value by OSC address pattern
+ */
+function registerSetParameterTool(server, connection) {
+    server.registerTool('set_parameter', {
+        title: 'Set Parameter (Low-Level)',
+        description: 'ADVANCED/LOW-LEVEL TOOL: Controls X32/M32 mixer parameters by setting specific values via raw OSC address patterns. Consider using semantic tools (channel_*, bus_*, etc.) for common operations. Use this tool for parameters not covered by semantic tools or for advanced automation.',
+        inputSchema: {
+            address: z
+                .string()
+                .describe('OSC address pattern for the parameter to control (e.g., "/ch/01/mix/fader" for channel 1 fader, "/main/st/mix/fader" for main stereo fader)'),
+            value: z
+                .union([z.string(), z.number()])
+                .describe('Value to set - typically 0.0-1.0 for faders, 0/1 for mutes, or specific values for other parameters')
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: true
+        }
+    }, async ({ address, value }) => {
+        if (!connection.connected) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Not connected to X32/M32 mixer. Use connection_connect first.'
+                    }
+                ],
+                isError: true
+            };
+        }
+        try {
+            await connection.setParameter(address, value);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Set ${address} = ${value}`
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to set parameter: ${error instanceof Error ? error.message : String(error)}`
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+}
+/**
+ * Register all generic parameter tools
+ */
+export function registerParameterTools(server, connection) {
+    registerGetParameterTool(server, connection);
+    registerSetParameterTool(server, connection);
+}
+//# sourceMappingURL=parameter.js.map

package/dist/esm/tools/parameter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter.js","sourceRoot":"","sources":["../../../src/tools/parameter.ts"],"names":[],"mappings":"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"}

package/dist/esm/tools/set-parameter.tool.d.ts

@@ -0,0 +1,8 @@
+import { Server } from '../server.js';
+import { X32Connection } from '../services/x32-connection.js';
+/**
+ * Register x32_set_parameter tool
+ * Sets parameter value by OSC address pattern
+ */
+export declare function registerSetParameterTool(server: Server, connection: X32Connection): void;
+//# sourceMappingURL=set-parameter.tool.d.ts.map

package/dist/esm/tools/set-parameter.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-parameter.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/set-parameter.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,GAAG,IAAI,CAmDxF"}