cucumberstudio-mcp 1.1.0

package/build/api/types.d.ts

@@ -0,0 +1,113 @@
+export interface CucumberStudioResponse<T = unknown> {
+    data: T;
+    included?: Record<string, unknown>[];
+    meta?: {
+        count?: number;
+        total_count?: number;
+    };
+}
+export interface BaseAttributes {
+    id: string;
+    type: string;
+    attributes: Record<string, unknown>;
+    relationships?: Record<string, unknown>;
+}
+export interface Project extends BaseAttributes {
+    type: 'projects';
+    attributes: {
+        name: string;
+        description?: string;
+        created_at: string;
+        updated_at: string;
+    };
+}
+export interface Scenario extends BaseAttributes {
+    type: 'scenarios';
+    attributes: {
+        name: string;
+        description?: string;
+        definition?: string;
+        created_at: string;
+        updated_at: string;
+        folder_id?: string;
+    };
+}
+export interface ActionWord extends BaseAttributes {
+    type: 'actionwords';
+    attributes: {
+        name: string;
+        description?: string;
+        definition?: string;
+        created_at: string;
+        updated_at: string;
+    };
+}
+export interface Folder extends BaseAttributes {
+    type: 'folders';
+    attributes: {
+        name: string;
+        description?: string;
+        created_at: string;
+        updated_at: string;
+        parent_id?: string;
+    };
+}
+export interface TestRun extends BaseAttributes {
+    type: 'test_runs';
+    attributes: {
+        name: string;
+        description?: string;
+        created_at: string;
+        updated_at: string;
+        execution_environment?: string;
+    };
+}
+export interface TestExecution extends BaseAttributes {
+    type: 'test_executions';
+    attributes: {
+        status: 'passed' | 'failed' | 'wip' | 'retest' | 'blocked' | 'skipped' | 'undefined';
+        created_at: string;
+        updated_at: string;
+        scenario_id: string;
+        test_run_id: string;
+    };
+}
+export interface Build extends BaseAttributes {
+    type: 'builds';
+    attributes: {
+        name: string;
+        description?: string;
+        created_at: string;
+        updated_at: string;
+    };
+}
+export interface ExecutionEnvironment extends BaseAttributes {
+    type: 'execution_environments';
+    attributes: {
+        name: string;
+        description?: string;
+        created_at: string;
+        updated_at: string;
+    };
+}
+export interface Tag extends BaseAttributes {
+    type: 'tags';
+    attributes: {
+        key: string;
+        value?: string;
+    };
+}
+export interface CucumberStudioError {
+    errors: Array<{
+        detail: string;
+        status: string;
+        title: string;
+    }>;
+}
+export interface ListParams extends Record<string, unknown> {
+    'page[number]'?: number;
+    'page[size]'?: number;
+    'filter[name]'?: string;
+    'filter[tags]'?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/api/types.d.ts.map

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

package/build/api/types.js

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

package/build/api/types.js.map

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

package/build/config/settings.d.ts

@@ -0,0 +1,123 @@
+import { z } from 'zod';
+declare const ConfigSchema: z.ZodObject<{
+    cucumberStudio: z.ZodObject<{
+        baseUrl: z.ZodDefault<z.ZodString>;
+        accessToken: z.ZodString;
+        clientId: z.ZodString;
+        uid: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        baseUrl: string;
+        accessToken: string;
+        clientId: string;
+        uid: string;
+    }, {
+        accessToken: string;
+        clientId: string;
+        uid: string;
+        baseUrl?: string | undefined;
+    }>;
+    server: z.ZodObject<{
+        name: z.ZodDefault<z.ZodString>;
+        version: z.ZodDefault<z.ZodString>;
+        transport: z.ZodDefault<z.ZodEnum<["stdio", "http", "streamable-http"]>>;
+        port: z.ZodDefault<z.ZodNumber>;
+        host: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        version: string;
+        transport: "stdio" | "http" | "streamable-http";
+        port: number;
+        host: string;
+    }, {
+        name?: string | undefined;
+        version?: string | undefined;
+        transport?: "stdio" | "http" | "streamable-http" | undefined;
+        port?: number | undefined;
+        host?: string | undefined;
+    }>;
+    logging: z.ZodObject<{
+        level: z.ZodDefault<z.ZodEnum<["error", "warn", "info", "debug", "trace"]>>;
+        logApiResponses: z.ZodDefault<z.ZodBoolean>;
+        logRequestBodies: z.ZodDefault<z.ZodBoolean>;
+        logResponseBodies: z.ZodDefault<z.ZodBoolean>;
+        transport: z.ZodDefault<z.ZodEnum<["console", "file", "stderr", "none"]>>;
+        filePath: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        transport: "console" | "file" | "stderr" | "none";
+        level: "info" | "error" | "warn" | "debug" | "trace";
+        logApiResponses: boolean;
+        logRequestBodies: boolean;
+        logResponseBodies: boolean;
+        filePath?: string | undefined;
+    }, {
+        transport?: "console" | "file" | "stderr" | "none" | undefined;
+        level?: "info" | "error" | "warn" | "debug" | "trace" | undefined;
+        logApiResponses?: boolean | undefined;
+        logRequestBodies?: boolean | undefined;
+        logResponseBodies?: boolean | undefined;
+        filePath?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    cucumberStudio: {
+        baseUrl: string;
+        accessToken: string;
+        clientId: string;
+        uid: string;
+    };
+    server: {
+        name: string;
+        version: string;
+        transport: "stdio" | "http" | "streamable-http";
+        port: number;
+        host: string;
+    };
+    logging: {
+        transport: "console" | "file" | "stderr" | "none";
+        level: "info" | "error" | "warn" | "debug" | "trace";
+        logApiResponses: boolean;
+        logRequestBodies: boolean;
+        logResponseBodies: boolean;
+        filePath?: string | undefined;
+    };
+}, {
+    cucumberStudio: {
+        accessToken: string;
+        clientId: string;
+        uid: string;
+        baseUrl?: string | undefined;
+    };
+    server: {
+        name?: string | undefined;
+        version?: string | undefined;
+        transport?: "stdio" | "http" | "streamable-http" | undefined;
+        port?: number | undefined;
+        host?: string | undefined;
+    };
+    logging: {
+        transport?: "console" | "file" | "stderr" | "none" | undefined;
+        level?: "info" | "error" | "warn" | "debug" | "trace" | undefined;
+        logApiResponses?: boolean | undefined;
+        logRequestBodies?: boolean | undefined;
+        logResponseBodies?: boolean | undefined;
+        filePath?: string | undefined;
+    };
+}>;
+export type Config = z.infer<typeof ConfigSchema>;
+export declare class ConfigManager {
+    private config;
+    /**
+     * Load configuration from environment variables
+     */
+    loadFromEnvironment(): Config;
+    /**
+     * Get current configuration
+     */
+    getConfig(): Config;
+    /**
+     * Validate that all required configuration is present
+     */
+    validate(): boolean;
+}
+export declare const configManager: ConfigManager;
+export {};
+//# sourceMappingURL=settings.d.ts.map

package/build/config/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/config/settings.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAYvB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsBhB,CAAA;AAEF,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAEjD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAsB;IAEpC;;OAEG;IACI,mBAAmB,IAAI,MAAM;IA2CpC;;OAEG;IACI,SAAS,IAAI,MAAM;IAO1B;;OAEG;IACI,QAAQ,IAAI,OAAO;CAQ3B;AAGD,eAAO,MAAM,aAAa,eAAsB,CAAA"}

package/build/config/settings.js

@@ -0,0 +1,97 @@
+import { config as loadDotenv } from 'dotenv';
+import { z } from 'zod';
+import { SERVER_NAME, SERVER_VERSION, DEFAULT_API_BASE_URL, DEFAULT_PORT, DEFAULT_HOST, DEFAULT_LOG_LEVEL, } from '../constants.js';
+// Configuration schema for type safety and validation
+const ConfigSchema = z.object({
+    cucumberStudio: z.object({
+        baseUrl: z.string().url().default(DEFAULT_API_BASE_URL),
+        accessToken: z.string().min(1),
+        clientId: z.string().min(1),
+        uid: z.string().min(1),
+    }),
+    server: z.object({
+        name: z.string().default(SERVER_NAME),
+        version: z.string().default(SERVER_VERSION),
+        transport: z.enum(['stdio', 'http', 'streamable-http']).default('stdio'),
+        port: z.number().int().min(1).max(65535).default(DEFAULT_PORT),
+        host: z.string().default(DEFAULT_HOST),
+    }),
+    logging: z.object({
+        level: z.enum(['error', 'warn', 'info', 'debug', 'trace']).default(DEFAULT_LOG_LEVEL),
+        logApiResponses: z.boolean().default(false),
+        logRequestBodies: z.boolean().default(false),
+        logResponseBodies: z.boolean().default(false),
+        transport: z.enum(['console', 'file', 'stderr', 'none']).default('stderr'),
+        filePath: z.string().optional(),
+    }),
+});
+export class ConfigManager {
+    config = null;
+    /**
+     * Load configuration from environment variables
+     */
+    loadFromEnvironment() {
+        // Auto-load .env file if it exists
+        loadDotenv({ path: '.env' });
+        const rawConfig = {
+            cucumberStudio: {
+                baseUrl: process.env.CUCUMBERSTUDIO_BASE_URL,
+                accessToken: process.env.CUCUMBERSTUDIO_ACCESS_TOKEN,
+                clientId: process.env.CUCUMBERSTUDIO_CLIENT_ID,
+                uid: process.env.CUCUMBERSTUDIO_UID,
+            },
+            server: {
+                name: process.env.MCP_SERVER_NAME,
+                version: process.env.MCP_SERVER_VERSION,
+                transport: process.env.MCP_TRANSPORT,
+                port: process.env.MCP_PORT ? parseInt(process.env.MCP_PORT, 10) : undefined,
+                host: process.env.MCP_HOST,
+            },
+            logging: {
+                level: process.env.LOG_LEVEL,
+                logApiResponses: process.env.LOG_API_RESPONSES === 'true',
+                logRequestBodies: process.env.LOG_REQUEST_BODIES === 'true',
+                logResponseBodies: process.env.LOG_RESPONSE_BODIES === 'true',
+                transport: process.env.LOG_TRANSPORT,
+                filePath: process.env.LOG_FILE,
+            },
+        };
+        try {
+            this.config = ConfigSchema.parse(rawConfig);
+            return this.config;
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                const missingFields = error.errors.map((e) => e.path.join('.')).join(', ');
+                throw new Error(`Configuration validation failed. Missing or invalid fields: ${missingFields}. ` +
+                    'Please ensure all required environment variables are set: ' +
+                    'CUCUMBERSTUDIO_ACCESS_TOKEN, CUCUMBERSTUDIO_CLIENT_ID, CUCUMBERSTUDIO_UID');
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        if (!this.config) {
+            throw new Error('Configuration not loaded. Call loadFromEnvironment() first.');
+        }
+        return this.config;
+    }
+    /**
+     * Validate that all required configuration is present
+     */
+    validate() {
+        try {
+            this.getConfig();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+// Singleton instance
+export const configManager = new ConfigManager();
+//# sourceMappingURL=settings.js.map

package/build/config/settings.js.map

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

package/build/constants.d.ts

@@ -0,0 +1,16 @@
+export declare const SERVER_NAME = "cucumberstudio-mcp";
+export declare const SERVER_VERSION = "1.1.0";
+export declare const PROTOCOL_VERSION = "2025-03-26";
+export declare const API_VERSION_HEADER = "application/vnd.api+json; version=1";
+export declare const API_TIMEOUT = 30000;
+export declare const DEFAULT_API_BASE_URL = "https://studio.cucumberstudio.com/api";
+export declare const DEFAULT_PORT = 3000;
+export declare const DEFAULT_HOST = "0.0.0.0";
+export declare const JSON_BODY_LIMIT = "10mb";
+export declare const DEFAULT_CORS_ORIGINS: string[];
+export declare const MAX_PAGE_SIZE = 100;
+export declare const DEFAULT_PAGE_SIZE = 20;
+export declare const REDACTED_STRING = "***REDACTED***";
+export declare const LOG_PREFIX = "\uD83E\uDD52 API";
+export declare const DEFAULT_LOG_LEVEL = "info";
+//# sourceMappingURL=constants.d.ts.map

package/build/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,uBAAe,CAAA;AACvC,eAAO,MAAM,cAAc,UAAkB,CAAA;AAC7C,eAAO,MAAM,gBAAgB,eAAe,CAAA;AAG5C,eAAO,MAAM,kBAAkB,wCAAwC,CAAA;AACvE,eAAO,MAAM,WAAW,QAAQ,CAAA;AAChC,eAAO,MAAM,oBAAoB,0CAA0C,CAAA;AAG3E,eAAO,MAAM,YAAY,OAAO,CAAA;AAChC,eAAO,MAAM,YAAY,YAAY,CAAA;AACrC,eAAO,MAAM,eAAe,SAAS,CAAA;AACrC,eAAO,MAAM,oBAAoB,UAAwC,CAAA;AAGzE,eAAO,MAAM,aAAa,MAAM,CAAA;AAChC,eAAO,MAAM,iBAAiB,KAAK,CAAA;AAGnC,eAAO,MAAM,eAAe,mBAAmB,CAAA;AAG/C,eAAO,MAAM,UAAU,qBAAW,CAAA;AAClC,eAAO,MAAM,iBAAiB,SAAS,CAAA"}

package/build/constants.js

@@ -0,0 +1,24 @@
+// Import build-time generated version
+import { PACKAGE_VERSION, PACKAGE_NAME } from './generated/version.js';
+// Server Configuration
+export const SERVER_NAME = PACKAGE_NAME;
+export const SERVER_VERSION = PACKAGE_VERSION; // Build-time constant from package.json
+export const PROTOCOL_VERSION = '2025-03-26'; // MCP protocol version
+// API Configuration
+export const API_VERSION_HEADER = 'application/vnd.api+json; version=1';
+export const API_TIMEOUT = 30000; // 30 seconds
+export const DEFAULT_API_BASE_URL = 'https://studio.cucumberstudio.com/api';
+// Network Configuration
+export const DEFAULT_PORT = 3000;
+export const DEFAULT_HOST = '0.0.0.0';
+export const JSON_BODY_LIMIT = '10mb';
+export const DEFAULT_CORS_ORIGINS = ['localhost', '127.0.0.1', '0.0.0.0'];
+// Pagination
+export const MAX_PAGE_SIZE = 100;
+export const DEFAULT_PAGE_SIZE = 20;
+// Security
+export const REDACTED_STRING = '***REDACTED***';
+// Logger
+export const LOG_PREFIX = '🥒 API';
+export const DEFAULT_LOG_LEVEL = 'info';
+//# sourceMappingURL=constants.js.map

package/build/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAEtE,uBAAuB;AACvB,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAA;AACvC,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,CAAA,CAAC,wCAAwC;AACtF,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAA,CAAC,uBAAuB;AAEpE,oBAAoB;AACpB,MAAM,CAAC,MAAM,kBAAkB,GAAG,qCAAqC,CAAA;AACvE,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAA,CAAC,aAAa;AAC9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,uCAAuC,CAAA;AAE3E,wBAAwB;AACxB,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAA;AAChC,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAA;AACrC,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAA;AACrC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,CAAC,CAAA;AAEzE,aAAa;AACb,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAA;AAChC,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAA;AAEnC,WAAW;AACX,MAAM,CAAC,MAAM,eAAe,GAAG,gBAAgB,CAAA;AAE/C,SAAS;AACT,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAA;AAClC,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAA"}

package/build/generated/version.d.ts

@@ -0,0 +1,3 @@
+export declare const PACKAGE_VERSION = "1.1.0";
+export declare const PACKAGE_NAME = "cucumberstudio-mcp";
+//# sourceMappingURL=version.d.ts.map

package/build/generated/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,eAAe,UAAU,CAAA;AACtC,eAAO,MAAM,YAAY,uBAAuB,CAAA"}

package/build/generated/version.js

@@ -0,0 +1,5 @@
+// Auto-generated version info - DO NOT EDIT
+// Generated at build time from package.json
+export const PACKAGE_VERSION = '1.1.0';
+export const PACKAGE_NAME = 'cucumberstudio-mcp';
+//# sourceMappingURL=version.js.map

package/build/generated/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,4CAA4C;AAE5C,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAA;AACtC,MAAM,CAAC,MAAM,YAAY,GAAG,oBAAoB,CAAA"}

package/build/index.d.ts

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

package/build/index.d.ts.map

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

package/build/index.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { config as loadDotenv } from 'dotenv';
+import { createCucumberStudioMcpServer } from './mcp-server.js';
+import { StreamableHttpTransport, TransportType } from './transports/index.js';
+import { StderrLogger, getLogLevel } from './utils/logger.js';
+/**
+ * Main entry point for the Cucumber Studio MCP Server
+ * Supports both STDIO and HTTP transports based on environment variables
+ */
+async function main() {
+    // Load .env file first to ensure environment variables are available
+    loadDotenv({ path: '.env' });
+    // Determine transport based on environment variable
+    const transportString = process.env.MCP_TRANSPORT?.toLowerCase() || 'stdio';
+    const transport = Object.values(TransportType).includes(transportString)
+        ? transportString
+        : TransportType.STDIO;
+    const port = parseInt(process.env.MCP_PORT || '3000', 10);
+    const host = process.env.MCP_HOST || '127.0.0.1';
+    console.error(`🎯 Starting Cucumber Studio MCP Server with ${transport} transport...`);
+    try {
+        switch (transport) {
+            case TransportType.HTTP:
+            case TransportType.STREAMABLE_HTTP: {
+                // HTTP/Streamable HTTP transport
+                const httpLogger = new StderrLogger({ level: getLogLevel(), prefix: '🌐 HTTP' });
+                const httpTransport = new StreamableHttpTransport(createCucumberStudioMcpServer, {
+                    port,
+                    host,
+                    cors: {
+                        origin: process.env.MCP_CORS_ORIGIN === 'false' ? false : true,
+                        credentials: true,
+                    },
+                }, httpLogger);
+                await httpTransport.start();
+                // Handle graceful shutdown for HTTP transport
+                const shutdown = async () => {
+                    console.error('🛑 Shutting down HTTP transport...');
+                    await httpTransport.close();
+                    process.exit(0);
+                };
+                process.on('SIGINT', shutdown);
+                process.on('SIGTERM', shutdown);
+                break;
+            }
+            case TransportType.STDIO:
+            default: {
+                // STDIO transport (default)
+                const server = createCucumberStudioMcpServer();
+                const stdioTransport = new StdioServerTransport();
+                console.error('🚀 CucumberStudio MCP Server running on stdio');
+                console.error('📡 Transport: STDIO (standard input/output)');
+                console.error('🔄 Protocol: MCP');
+                await server.connect(stdioTransport);
+                break;
+            }
+        }
+    }
+    catch (error) {
+        console.error(`❌ ${transport} transport failed to start:`, error);
+        process.exit(1);
+    }
+}
+// Handle graceful shutdown for STDIO transport
+process.on('SIGINT', () => {
+    console.error('🛑 Received SIGINT, shutting down gracefully...');
+    process.exit(0);
+});
+process.on('SIGTERM', () => {
+    console.error('🛑 Received SIGTERM, shutting down gracefully...');
+    process.exit(0);
+});
+// Run if this file is executed directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main().catch((error) => {
+        console.error('❌ Unhandled error:', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/build/index.js.map

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

package/build/mcp-server.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Create and configure a new CucumberStudio MCP Server
+ */
+export declare function createCucumberStudioMcpServer(): McpServer;
+//# sourceMappingURL=mcp-server.d.ts.map

package/build/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAanE;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,SAAS,CAYzD"}