x-m32-mcp-server 2.1.0

package/dist/esm/validation/ajv-provider.d.ts

@@ -0,0 +1,53 @@
+/**
+ * AJV-based JSON Schema validator provider
+ */
+import { Ajv } from 'ajv';
+import type { JsonSchemaType, JsonSchemaValidator, jsonSchemaValidator } from './types.js';
+/**
+ * @example
+ * ```typescript
+ * // Use with default AJV instance (recommended)
+ * import { AjvJsonSchemaValidator } from '@modelcontextprotocol/sdk/validation/ajv';
+ * const validator = new AjvJsonSchemaValidator();
+ *
+ * // Use with custom AJV instance
+ * import { Ajv } from 'ajv';
+ * const ajv = new Ajv({ strict: true, allErrors: true });
+ * const validator = new AjvJsonSchemaValidator(ajv);
+ * ```
+ */
+export declare class AjvJsonSchemaValidator implements jsonSchemaValidator {
+    private _ajv;
+    /**
+     * Create an AJV validator
+     *
+     * @param ajv - Optional pre-configured AJV instance. If not provided, a default instance will be created.
+     *
+     * @example
+     * ```typescript
+     * // Use default configuration (recommended for most cases)
+     * import { AjvJsonSchemaValidator } from '@modelcontextprotocol/sdk/validation/ajv';
+     * const validator = new AjvJsonSchemaValidator();
+     *
+     * // Or provide custom AJV instance for advanced configuration
+     * import { Ajv } from 'ajv';
+     * import addFormats from 'ajv-formats';
+     *
+     * const ajv = new Ajv({ validateFormats: true });
+     * addFormats(ajv);
+     * const validator = new AjvJsonSchemaValidator(ajv);
+     * ```
+     */
+    constructor(ajv?: Ajv);
+    /**
+     * Create a validator for the given JSON Schema
+     *
+     * The validator is compiled once and can be reused multiple times.
+     * If the schema has an $id, it will be cached by AJV automatically.
+     *
+     * @param schema - Standard JSON Schema object
+     * @returns A validator function that validates input data
+     */
+    getValidator<T>(schema: JsonSchemaType): JsonSchemaValidator<T>;
+}
+//# sourceMappingURL=ajv-provider.d.ts.map

package/dist/esm/validation/ajv-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ajv-provider.d.ts","sourceRoot":"","sources":["../../../src/validation/ajv-provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAA6B,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAgBtH;;;;;;;;;;;;GAYG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAC9D,OAAO,CAAC,IAAI,CAAM;IAElB;;;;;;;;;;;;;;;;;;;OAmBG;gBACS,GAAG,CAAC,EAAE,GAAG;IAIrB;;;;;;;;OAQG;IACH,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,GAAG,mBAAmB,CAAC,CAAC,CAAC;CAyBlE"}

package/dist/esm/validation/ajv-provider.js

@@ -0,0 +1,88 @@
+/**
+ * AJV-based JSON Schema validator provider
+ */
+import { Ajv } from 'ajv';
+import _addFormats from 'ajv-formats';
+function createDefaultAjvInstance() {
+    const ajv = new Ajv({
+        strict: false,
+        validateFormats: true,
+        validateSchema: false,
+        allErrors: true
+    });
+    const addFormats = _addFormats;
+    addFormats(ajv);
+    return ajv;
+}
+/**
+ * @example
+ * ```typescript
+ * // Use with default AJV instance (recommended)
+ * import { AjvJsonSchemaValidator } from '@modelcontextprotocol/sdk/validation/ajv';
+ * const validator = new AjvJsonSchemaValidator();
+ *
+ * // Use with custom AJV instance
+ * import { Ajv } from 'ajv';
+ * const ajv = new Ajv({ strict: true, allErrors: true });
+ * const validator = new AjvJsonSchemaValidator(ajv);
+ * ```
+ */
+export class AjvJsonSchemaValidator {
+    /**
+     * Create an AJV validator
+     *
+     * @param ajv - Optional pre-configured AJV instance. If not provided, a default instance will be created.
+     *
+     * @example
+     * ```typescript
+     * // Use default configuration (recommended for most cases)
+     * import { AjvJsonSchemaValidator } from '@modelcontextprotocol/sdk/validation/ajv';
+     * const validator = new AjvJsonSchemaValidator();
+     *
+     * // Or provide custom AJV instance for advanced configuration
+     * import { Ajv } from 'ajv';
+     * import addFormats from 'ajv-formats';
+     *
+     * const ajv = new Ajv({ validateFormats: true });
+     * addFormats(ajv);
+     * const validator = new AjvJsonSchemaValidator(ajv);
+     * ```
+     */
+    constructor(ajv) {
+        this._ajv = ajv !== null && ajv !== void 0 ? ajv : createDefaultAjvInstance();
+    }
+    /**
+     * Create a validator for the given JSON Schema
+     *
+     * The validator is compiled once and can be reused multiple times.
+     * If the schema has an $id, it will be cached by AJV automatically.
+     *
+     * @param schema - Standard JSON Schema object
+     * @returns A validator function that validates input data
+     */
+    getValidator(schema) {
+        var _a;
+        // Check if schema has $id and is already compiled/cached
+        const ajvValidator = '$id' in schema && typeof schema.$id === 'string'
+            ? ((_a = this._ajv.getSchema(schema.$id)) !== null && _a !== void 0 ? _a : this._ajv.compile(schema))
+            : this._ajv.compile(schema);
+        return (input) => {
+            const valid = ajvValidator(input);
+            if (valid) {
+                return {
+                    valid: true,
+                    data: input,
+                    errorMessage: undefined
+                };
+            }
+            else {
+                return {
+                    valid: false,
+                    data: undefined,
+                    errorMessage: this._ajv.errorsText(ajvValidator.errors)
+                };
+            }
+        };
+    }
+}
+//# sourceMappingURL=ajv-provider.js.map

package/dist/esm/validation/ajv-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ajv-provider.js","sourceRoot":"","sources":["../../../src/validation/ajv-provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC1B,OAAO,WAAW,MAAM,aAAa,CAAC;AAGtC,SAAS,wBAAwB;IAC7B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC;QAChB,MAAM,EAAE,KAAK;QACb,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,KAAK;QACrB,SAAS,EAAE,IAAI;KAClB,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,WAAoD,CAAC;IACxE,UAAU,CAAC,GAAG,CAAC,CAAC;IAEhB,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,sBAAsB;IAG/B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,YAAY,GAAS;QACjB,IAAI,CAAC,IAAI,GAAG,GAAG,aAAH,GAAG,cAAH,GAAG,GAAI,wBAAwB,EAAE,CAAC;IAClD,CAAC;IAED;;;;;;;;OAQG;IACH,YAAY,CAAI,MAAsB;;QAClC,yDAAyD;QACzD,MAAM,YAAY,GACd,KAAK,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ;YAC7C,CAAC,CAAC,CAAC,MAAA,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,mCAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAChE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAEpC,OAAO,CAAC,KAAc,EAAgC,EAAE;YACpD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;YAElC,IAAI,KAAK,EAAE,CAAC;gBACR,OAAO;oBACH,KAAK,EAAE,IAAI;oBACX,IAAI,EAAE,KAAU;oBAChB,YAAY,EAAE,SAAS;iBAC1B,CAAC;YACN,CAAC;iBAAM,CAAC;gBACJ,OAAO;oBACH,KAAK,EAAE,KAAK;oBACZ,IAAI,EAAE,SAAS;oBACf,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC;iBAC1D,CAAC;YACN,CAAC;QACL,CAAC,CAAC;IACN,CAAC;CACJ"}

package/dist/esm/validation/cfworker-provider.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Cloudflare Worker-compatible JSON Schema validator provider
+ *
+ * This provider uses @cfworker/json-schema for validation without code generation,
+ * making it compatible with edge runtimes like Cloudflare Workers that restrict
+ * eval and new Function.
+ *
+ */
+import type { JsonSchemaType, JsonSchemaValidator, jsonSchemaValidator } from './types.js';
+/**
+ * JSON Schema draft version supported by @cfworker/json-schema
+ */
+export type CfWorkerSchemaDraft = '4' | '7' | '2019-09' | '2020-12';
+/**
+ *
+ * @example
+ * ```typescript
+ * // Use with default configuration (2020-12, shortcircuit)
+ * const validator = new CfWorkerJsonSchemaValidator();
+ *
+ * // Use with custom configuration
+ * const validator = new CfWorkerJsonSchemaValidator({
+ *   draft: '2020-12',
+ *   shortcircuit: false // Report all errors
+ * });
+ * ```
+ */
+export declare class CfWorkerJsonSchemaValidator implements jsonSchemaValidator {
+    private shortcircuit;
+    private draft;
+    /**
+     * Create a validator
+     *
+     * @param options - Configuration options
+     * @param options.shortcircuit - If true, stop validation after first error (default: true)
+     * @param options.draft - JSON Schema draft version to use (default: '2020-12')
+     */
+    constructor(options?: {
+        shortcircuit?: boolean;
+        draft?: CfWorkerSchemaDraft;
+    });
+    /**
+     * Create a validator for the given JSON Schema
+     *
+     * Unlike AJV, this validator is not cached internally
+     *
+     * @param schema - Standard JSON Schema object
+     * @returns A validator function that validates input data
+     */
+    getValidator<T>(schema: JsonSchemaType): JsonSchemaValidator<T>;
+}
+//# sourceMappingURL=cfworker-provider.d.ts.map

package/dist/esm/validation/cfworker-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cfworker-provider.d.ts","sourceRoot":"","sources":["../../../src/validation/cfworker-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAA6B,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtH;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,GAAG,GAAG,GAAG,GAAG,SAAS,GAAG,SAAS,CAAC;AAEpE;;;;;;;;;;;;;GAaG;AACH,qBAAa,2BAA4B,YAAW,mBAAmB;IACnE,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,KAAK,CAAsB;IAEnC;;;;;;OAMG;gBACS,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,mBAAmB,CAAA;KAAE;IAK7E;;;;;;;OAOG;IACH,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,GAAG,mBAAmB,CAAC,CAAC,CAAC;CAsBlE"}

package/dist/esm/validation/cfworker-provider.js

@@ -0,0 +1,67 @@
+/**
+ * Cloudflare Worker-compatible JSON Schema validator provider
+ *
+ * This provider uses @cfworker/json-schema for validation without code generation,
+ * making it compatible with edge runtimes like Cloudflare Workers that restrict
+ * eval and new Function.
+ *
+ */
+import { Validator } from '@cfworker/json-schema';
+/**
+ *
+ * @example
+ * ```typescript
+ * // Use with default configuration (2020-12, shortcircuit)
+ * const validator = new CfWorkerJsonSchemaValidator();
+ *
+ * // Use with custom configuration
+ * const validator = new CfWorkerJsonSchemaValidator({
+ *   draft: '2020-12',
+ *   shortcircuit: false // Report all errors
+ * });
+ * ```
+ */
+export class CfWorkerJsonSchemaValidator {
+    /**
+     * Create a validator
+     *
+     * @param options - Configuration options
+     * @param options.shortcircuit - If true, stop validation after first error (default: true)
+     * @param options.draft - JSON Schema draft version to use (default: '2020-12')
+     */
+    constructor(options) {
+        var _a, _b;
+        this.shortcircuit = (_a = options === null || options === void 0 ? void 0 : options.shortcircuit) !== null && _a !== void 0 ? _a : true;
+        this.draft = (_b = options === null || options === void 0 ? void 0 : options.draft) !== null && _b !== void 0 ? _b : '2020-12';
+    }
+    /**
+     * Create a validator for the given JSON Schema
+     *
+     * Unlike AJV, this validator is not cached internally
+     *
+     * @param schema - Standard JSON Schema object
+     * @returns A validator function that validates input data
+     */
+    getValidator(schema) {
+        const cfSchema = schema;
+        const validator = new Validator(cfSchema, this.draft, this.shortcircuit);
+        return (input) => {
+            const result = validator.validate(input);
+            if (result.valid) {
+                return {
+                    valid: true,
+                    data: input,
+                    errorMessage: undefined
+                };
+            }
+            else {
+                return {
+                    valid: false,
+                    data: undefined,
+                    errorMessage: result.errors.map(err => `${err.instanceLocation}: ${err.error}`).join('; ')
+                };
+            }
+        };
+    }
+}
+//# sourceMappingURL=cfworker-provider.js.map

package/dist/esm/validation/cfworker-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cfworker-provider.js","sourceRoot":"","sources":["../../../src/validation/cfworker-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAe,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAQ/D;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,2BAA2B;IAIpC;;;;;;OAMG;IACH,YAAY,OAAiE;;QACzE,IAAI,CAAC,YAAY,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,YAAY,mCAAI,IAAI,CAAC;QAClD,IAAI,CAAC,KAAK,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,mCAAI,SAAS,CAAC;IAC7C,CAAC;IAED;;;;;;;OAOG;IACH,YAAY,CAAI,MAAsB;QAClC,MAAM,QAAQ,GAAG,MAA2B,CAAC;QAC7C,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAEzE,OAAO,CAAC,KAAc,EAAgC,EAAE;YACpD,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAEzC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACf,OAAO;oBACH,KAAK,EAAE,IAAI;oBACX,IAAI,EAAE,KAAU;oBAChB,YAAY,EAAE,SAAS;iBAC1B,CAAC;YACN,CAAC;iBAAM,CAAC;gBACJ,OAAO;oBACH,KAAK,EAAE,KAAK;oBACZ,IAAI,EAAE,SAAS;oBACf,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,gBAAgB,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;iBAC7F,CAAC;YACN,CAAC;QACL,CAAC,CAAC;IACN,CAAC;CACJ"}

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

@@ -0,0 +1,29 @@
+/**
+ * JSON Schema validation
+ *
+ * This module provides configurable JSON Schema validation for the MCP SDK.
+ * Choose a validator based on your runtime environment:
+ *
+ * - AjvJsonSchemaValidator: Best for Node.js (default, fastest)
+ *   Import from: @modelcontextprotocol/sdk/validation/ajv
+ *   Requires peer dependencies: ajv, ajv-formats
+ *
+ * - CfWorkerJsonSchemaValidator: Best for edge runtimes
+ *   Import from: @modelcontextprotocol/sdk/validation/cfworker
+ *   Requires peer dependency: @cfworker/json-schema
+ *
+ * @example
+ * ```typescript
+ * // For Node.js with AJV
+ * import { AjvJsonSchemaValidator } from '@modelcontextprotocol/sdk/validation/ajv';
+ * const validator = new AjvJsonSchemaValidator();
+ *
+ * // For Cloudflare Workers
+ * import { CfWorkerJsonSchemaValidator } from '@modelcontextprotocol/sdk/validation/cfworker';
+ * const validator = new CfWorkerJsonSchemaValidator();
+ * ```
+ *
+ * @module validation
+ */
+export type { JsonSchemaType, JsonSchemaValidator, JsonSchemaValidatorResult, jsonSchemaValidator } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/esm/validation/index.js

@@ -0,0 +1,29 @@
+/**
+ * JSON Schema validation
+ *
+ * This module provides configurable JSON Schema validation for the MCP SDK.
+ * Choose a validator based on your runtime environment:
+ *
+ * - AjvJsonSchemaValidator: Best for Node.js (default, fastest)
+ *   Import from: @modelcontextprotocol/sdk/validation/ajv
+ *   Requires peer dependencies: ajv, ajv-formats
+ *
+ * - CfWorkerJsonSchemaValidator: Best for edge runtimes
+ *   Import from: @modelcontextprotocol/sdk/validation/cfworker
+ *   Requires peer dependency: @cfworker/json-schema
+ *
+ * @example
+ * ```typescript
+ * // For Node.js with AJV
+ * import { AjvJsonSchemaValidator } from '@modelcontextprotocol/sdk/validation/ajv';
+ * const validator = new AjvJsonSchemaValidator();
+ *
+ * // For Cloudflare Workers
+ * import { CfWorkerJsonSchemaValidator } from '@modelcontextprotocol/sdk/validation/cfworker';
+ * const validator = new CfWorkerJsonSchemaValidator();
+ * ```
+ *
+ * @module validation
+ */
+export {};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG"}

package/dist/esm/validation/types.d.ts

@@ -0,0 +1,55 @@
+import type { Schema } from '@cfworker/json-schema';
+/**
+ * Result of a JSON Schema validation operation
+ */
+export type JsonSchemaValidatorResult<T> = {
+    valid: true;
+    data: T;
+    errorMessage: undefined;
+} | {
+    valid: false;
+    data: undefined;
+    errorMessage: string;
+};
+/**
+ * A validator function that validates data against a JSON Schema
+ */
+export type JsonSchemaValidator<T> = (input: unknown) => JsonSchemaValidatorResult<T>;
+/**
+ * Provider interface for creating validators from JSON Schemas
+ *
+ * This is the main extension point for custom validator implementations.
+ * Implementations should:
+ * - Support JSON Schema Draft 2020-12 (or be compatible with it)
+ * - Return validator functions that can be called multiple times
+ * - Handle schema compilation/caching internally
+ * - Provide clear error messages on validation failure
+ *
+ * @example
+ * ```typescript
+ * class MyValidatorProvider implements jsonSchemaValidator {
+ *   getValidator<T>(schema: JsonSchemaType<T>): JsonSchemaValidator<T> {
+ *     // Compile/cache validator from schema
+ *     return (input: unknown) => {
+ *       // Validate input against schema
+ *       if (valid) {
+ *         return { valid: true, data: input as T, errorMessage: undefined };
+ *       } else {
+ *         return { valid: false, data: undefined, errorMessage: 'Error details' };
+ *       }
+ *     };
+ *   }
+ * }
+ * ```
+ */
+export interface jsonSchemaValidator {
+    /**
+     * Create a validator for the given JSON Schema
+     *
+     * @param schema - Standard JSON Schema object
+     * @returns A validator function that can be called multiple times
+     */
+    getValidator<T>(schema: JsonSchemaType): JsonSchemaValidator<T>;
+}
+export type JsonSchemaType = Schema;
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/validation/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/validation/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,yBAAyB,CAAC,CAAC,IACjC;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,YAAY,EAAE,SAAS,CAAA;CAAE,GACjD;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,KAAK,yBAAyB,CAAC,CAAC,CAAC,CAAC;AAEtF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;;;OAKG;IACH,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;CACnE;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC"}

package/dist/esm/validation/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/validation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/validation/types.ts"],"names":[],"mappings":""}

package/dist/esm/x32-server/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/x32-server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/x32-server/index.ts"],"names":[],"mappings":""}

package/dist/esm/x32-server/index.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+import { McpServer } from '../server/mcp.js';
+import { StdioServerTransport } from '../server/stdio.js';
+import { X32Connection } from './x32-connection.js';
+import { registerConnectTool, registerInfoTool, registerStatusTool, registerGetParameterTool, registerSetParameterTool, registerChannelTool } from './tools/index.js';
+/**
+ * X32 MCP Server
+ * Model Context Protocol server for X32/M32 mixer control
+ */
+async function main() {
+    // Create X32 connection instance
+    const connection = new X32Connection();
+    // Create MCP server
+    const server = new McpServer({
+        name: 'x32-mcp-server',
+        version: '1.0.0'
+    }, {
+        capabilities: {
+            tools: {}
+        }
+    });
+    // Register all tools
+    registerConnectTool(server, connection);
+    registerInfoTool(server, connection);
+    registerStatusTool(server, connection);
+    registerGetParameterTool(server, connection);
+    registerSetParameterTool(server, connection);
+    registerChannelTool(server, connection);
+    // Setup connection event handlers
+    connection.on('connected', () => {
+        console.error('X32 Connected');
+    });
+    connection.on('disconnected', () => {
+        console.error('X32 Disconnected');
+    });
+    connection.on('error', error => {
+        console.error('X32 Error:', error);
+    });
+    // Create stdio transport
+    const transport = new StdioServerTransport();
+    // Connect server to transport
+    await server.connect(transport);
+    console.error('X32 MCP Server running on stdio');
+    console.error('Available tools:');
+    console.error('  - x32_connect: Connect to X32/M32 mixer');
+    console.error('  - x32_get_info: Get console information');
+    console.error('  - x32_get_status: Get current status');
+    console.error('  - x32_get_parameter: Get parameter by OSC address');
+    console.error('  - x32_set_parameter: Set parameter by OSC address');
+    console.error('  - x32_channel: Get/set channel parameters');
+    // Handle graceful shutdown
+    process.on('SIGINT', async () => {
+        console.error('\nShutting down...');
+        if (connection.connected) {
+            await connection.disconnect();
+        }
+        process.exit(0);
+    });
+    process.on('SIGTERM', async () => {
+        console.error('\nShutting down...');
+        if (connection.connected) {
+            await connection.disconnect();
+        }
+        process.exit(0);
+    });
+}
+main().catch(error => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/esm/x32-server/index.js.map

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

package/dist/esm/x32-server/tools/channel.tool.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from '../../server/mcp.js';
+import { X32Connection } from '../x32-connection.js';
+/**
+ * Register x32_channel tool
+ * High-level API for channel parameter access
+ */
+export declare function registerChannelTool(server: McpServer, connection: X32Connection): void;
+//# sourceMappingURL=channel.tool.d.ts.map

package/dist/esm/x32-server/tools/channel.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.tool.d.ts","sourceRoot":"","sources":["../../../../src/x32-server/tools/channel.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,GAAG,IAAI,CA6EtF"}

package/dist/esm/x32-server/tools/channel.tool.js

@@ -0,0 +1,79 @@
+import { z } from 'zod';
+/**
+ * Register x32_channel tool
+ * High-level API for channel parameter access
+ */
+export function registerChannelTool(server, connection) {
+    server.tool('x32_channel', 'Get or set channel parameters (high-level API for channels 1-32)', {
+        channel: z.number().min(1).max(32).describe('Channel number (1-32)'),
+        action: z.enum(['get', 'set']).describe('Action type: get or set'),
+        parameter: z.string().describe('Parameter path (e.g., mix/fader, config/name, eq/1/f)'),
+        value: z.union([z.string(), z.number()]).optional().describe('Value to set (required for set action)')
+    }, {
+        title: 'X32 Channel Control',
+        readOnlyHint: false,
+        destructiveHint: false, // Depends on action
+        idempotentHint: false,
+        openWorldHint: true
+    }, async ({ channel, action, parameter, value }) => {
+        if (!connection.connected) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Not connected to X32/M32 mixer. Use x32_connect first.'
+                    }
+                ],
+                isError: true
+            };
+        }
+        try {
+            if (action === 'get') {
+                const result = await connection.getChannelParameter(channel, parameter);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Channel ${channel} ${parameter} = ${JSON.stringify(result)}`
+                        }
+                    ]
+                };
+            }
+            else {
+                // action === 'set'
+                if (value === undefined) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'Value is required for set action'
+                            }
+                        ],
+                        isError: true
+                    };
+                }
+                await connection.setChannelParameter(channel, parameter, value);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Set channel ${channel} ${parameter} = ${value}`
+                        }
+                    ]
+                };
+            }
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to ${action} channel parameter: ${error instanceof Error ? error.message : String(error)}`
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+}
+//# sourceMappingURL=channel.tool.js.map

package/dist/esm/x32-server/tools/channel.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.tool.js","sourceRoot":"","sources":["../../../../src/x32-server/tools/channel.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,UAAyB;IAC5E,MAAM,CAAC,IAAI,CACP,aAAa,EACb,kEAAkE,EAClE;QACI,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QACpE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QAClE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;QACvF,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;KACzG,EACD;QACI,KAAK,EAAE,qBAAqB;QAC5B,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,KAAK,EAAE,oBAAoB;QAC5C,cAAc,EAAE,KAAK;QACrB,aAAa,EAAE,IAAI;KACtB,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,EAA2B,EAAE;QACrE,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,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;gBACnB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;gBACxE,OAAO;oBACH,OAAO,EAAE;wBACL;4BACI,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,WAAW,OAAO,IAAI,SAAS,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE;yBACtE;qBACJ;iBACJ,CAAC;YACN,CAAC;iBAAM,CAAC;gBACJ,mBAAmB;gBACnB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACtB,OAAO;wBACH,OAAO,EAAE;4BACL;gCACI,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,kCAAkC;6BAC3C;yBACJ;wBACD,OAAO,EAAE,IAAI;qBAChB,CAAC;gBACN,CAAC;gBACD,MAAM,UAAU,CAAC,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;gBAChE,OAAO;oBACH,OAAO,EAAE;wBACL;4BACI,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,eAAe,OAAO,IAAI,SAAS,MAAM,KAAK,EAAE;yBACzD;qBACJ;iBACJ,CAAC;YACN,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,aAAa,MAAM,uBAAuB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBAC3G;iBACJ;gBACD,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/esm/x32-server/tools/connect.tool.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from '../../server/mcp.js';
+import { X32Connection } from '../x32-connection.js';
+/**
+ * Register x32_connect tool
+ * Establishes connection to X32/M32 mixer
+ */
+export declare function registerConnectTool(server: McpServer, connection: X32Connection): void;
+//# sourceMappingURL=connect.tool.d.ts.map

package/dist/esm/x32-server/tools/connect.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.tool.d.ts","sourceRoot":"","sources":["../../../../src/x32-server/tools/connect.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,GAAG,IAAI,CAkDtF"}