@justanothermldude/mcp-exec 0.1.0

package/dist/tools/execute-with-context.js

@@ -0,0 +1,223 @@
+import { SandboxExecutor } from '../sandbox/index.js';
+import { MCPBridge } from '../bridge/index.js';
+import { DEFAULT_TIMEOUT_MS } from '../types/execution.js';
+/**
+ * MCP Tool definition for execute_with_context
+ */
+export const executeWithContextTool = {
+    name: 'execute_with_context',
+    description: 'Execute TypeScript/JavaScript code with pre-injected context variables. The context object is available as a global `context` variable in the executed code.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            code: {
+                type: 'string',
+                description: 'The TypeScript/JavaScript code to execute',
+            },
+            context: {
+                type: 'object',
+                description: 'Context object to inject into code execution (available as global `context` variable)',
+                additionalProperties: true,
+            },
+            timeout_ms: {
+                type: 'number',
+                description: `Maximum execution time in milliseconds (default: ${DEFAULT_TIMEOUT_MS})`,
+            },
+        },
+        required: ['code'],
+    },
+};
+/**
+ * Serialize context to JSON with error handling for circular references
+ * @param context - The context object to serialize
+ * @returns Serialized JSON string
+ * @throws Error if context contains non-serializable values
+ */
+function serializeContext(context) {
+    try {
+        return JSON.stringify(context);
+    }
+    catch (error) {
+        if (error instanceof TypeError && error.message.includes('circular')) {
+            throw new Error('Context contains circular references and cannot be serialized');
+        }
+        throw new Error(`Failed to serialize context: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Generate context injection code that creates a global `context` variable.
+ * Uses Base64 encoding to prevent injection attacks via malicious context values.
+ * @param context - The context object to inject
+ * @returns Code string that declares the context variable
+ */
+function generateContextInjection(context) {
+    const serializedContext = serializeContext(context);
+    const base64Context = Buffer.from(serializedContext, 'utf-8').toString('base64');
+    return `// Context injection (Base64 encoded for security)
+declare global {
+  var context: Record<string, unknown>;
+}
+globalThis.context = JSON.parse(Buffer.from('${base64Context}', 'base64').toString('utf-8'));
+
+`;
+}
+/**
+ * Creates the execute_with_context handler function
+ *
+ * @param pool - Server pool for MCP connections
+ * @param config - Optional handler configuration
+ * @returns Handler function for execute_with_context tool
+ */
+export function createExecuteWithContextHandler(pool, config = {}) {
+    // Ensure bridge port matches sandbox network config
+    const bridgePort = config.bridgeConfig?.port ?? 3000;
+    const sandboxConfig = {
+        ...config.sandboxConfig,
+        mcpBridgePort: bridgePort,
+    };
+    const executor = new SandboxExecutor(sandboxConfig);
+    const bridge = new MCPBridge(pool, {
+        ...config.bridgeConfig,
+        port: bridgePort,
+    });
+    /**
+     * Execute with context handler - orchestrates context injection, bridge, executor, and cleanup
+     */
+    return async function executeWithContextHandler(args) {
+        const { code, context = {}, timeout_ms = DEFAULT_TIMEOUT_MS } = args;
+        // Validate input
+        if (!code || typeof code !== 'string') {
+            return {
+                content: [{ type: 'text', text: 'Error: code parameter is required and must be a string' }],
+                isError: true,
+            };
+        }
+        if (context !== undefined && (typeof context !== 'object' || context === null || Array.isArray(context))) {
+            return {
+                content: [{ type: 'text', text: 'Error: context must be an object' }],
+                isError: true,
+            };
+        }
+        if (timeout_ms !== undefined && (typeof timeout_ms !== 'number' || timeout_ms <= 0)) {
+            return {
+                content: [{ type: 'text', text: 'Error: timeout_ms must be a positive number' }],
+                isError: true,
+            };
+        }
+        // Generate context injection code
+        let contextInjection = '';
+        try {
+            if (Object.keys(context).length > 0) {
+                contextInjection = generateContextInjection(context);
+            }
+            else {
+                // Provide empty context object if no context provided
+                contextInjection = `// Empty context
+declare global {
+  var context: Record<string, unknown>;
+}
+globalThis.context = {};
+
+`;
+            }
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+        // Compose final code: context injection prepended to user code
+        // The executor will add MCP preamble after context injection
+        const composedCode = contextInjection + code;
+        let result = null;
+        try {
+            // Step 1: Start the MCP bridge server
+            await bridge.start();
+            // Step 2: Execute code in sandbox (executor adds MCP preamble)
+            result = await executor.execute(composedCode, timeout_ms);
+            // Step 3: Stop the bridge server
+            await bridge.stop();
+            // Step 4: Format and return result
+            return formatResult(result);
+        }
+        catch (error) {
+            // Ensure bridge is stopped on error
+            try {
+                if (bridge.isRunning()) {
+                    await bridge.stop();
+                }
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            // Return error with any partial output
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return formatErrorResult(errorMessage, result);
+        }
+    };
+}
+/**
+ * Format a successful execution result
+ */
+function formatResult(result) {
+    const lines = [];
+    // Add output
+    if (result.output.length > 0) {
+        lines.push(...result.output);
+    }
+    // Add error if present (non-fatal stderr)
+    if (result.error) {
+        lines.push(`[stderr]: ${result.error}`);
+    }
+    // Add execution time
+    lines.push(`[Execution completed in ${result.durationMs}ms]`);
+    const hasError = !!result.error;
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+        isError: hasError,
+    };
+}
+/**
+ * Format an error result with optional partial output
+ */
+function formatErrorResult(errorMessage, partialResult) {
+    const lines = [];
+    // Add partial output if available
+    if (partialResult?.output.length) {
+        lines.push('[Partial output]:');
+        lines.push(...partialResult.output);
+        lines.push('');
+    }
+    // Add error message
+    lines.push(`Error: ${errorMessage}`);
+    // Add duration if available
+    if (partialResult?.durationMs) {
+        lines.push(`[Execution failed after ${partialResult.durationMs}ms]`);
+    }
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+        isError: true,
+    };
+}
+/**
+ * Type guard for ExecuteWithContextInput
+ */
+export function isExecuteWithContextInput(args) {
+    if (typeof args !== 'object' || args === null) {
+        return false;
+    }
+    const input = args;
+    // code must be a string
+    if (typeof input.code !== 'string') {
+        return false;
+    }
+    // context, if provided, must be an object (not array, not null)
+    if (input.context !== undefined) {
+        if (typeof input.context !== 'object' || input.context === null || Array.isArray(input.context)) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=execute-with-context.js.map

package/dist/tools/execute-with-context.js.map

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

package/dist/tools/execute-with-wrappers.d.ts

@@ -0,0 +1,69 @@
+/**
+ * execute_code_with_wrappers MCP tool handler
+ * Executes code with auto-generated typed wrappers for specified MCP servers
+ */
+import type { ServerPool } from '@justanothermldude/meta-mcp-core';
+import { type SandboxExecutorConfig } from '../sandbox/index.js';
+import { type MCPBridgeConfig } from '../bridge/index.js';
+import type { CallToolResult } from './execute-code.js';
+/**
+ * Input for execute_code_with_wrappers tool
+ */
+export interface ExecuteWithWrappersInput {
+    /** The code to execute */
+    code: string;
+    /** Array of server names to generate wrappers for */
+    wrappers: string[];
+    /** Execution timeout in milliseconds (default: 30000) */
+    timeout_ms?: number;
+}
+/**
+ * MCP Tool definition for execute_code_with_wrappers
+ */
+export declare const executeCodeWithWrappersTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            code: {
+                type: string;
+                description: string;
+            };
+            wrappers: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            timeout_ms: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * Configuration for the execute_code_with_wrappers handler
+ */
+export interface ExecuteWithWrappersHandlerConfig {
+    /** Configuration for the sandbox executor */
+    sandboxConfig?: SandboxExecutorConfig;
+    /** Configuration for the MCP bridge */
+    bridgeConfig?: MCPBridgeConfig;
+}
+/**
+ * Type guard for ExecuteWithWrappersInput
+ */
+export declare function isExecuteWithWrappersInput(args: unknown): args is ExecuteWithWrappersInput;
+/**
+ * Creates the execute_code_with_wrappers handler function
+ *
+ * @param pool - Server pool for MCP connections
+ * @param config - Optional handler configuration
+ * @returns Handler function for execute_code_with_wrappers tool
+ */
+export declare function createExecuteWithWrappersHandler(pool: ServerPool, config?: ExecuteWithWrappersHandlerConfig): (args: ExecuteWithWrappersInput) => Promise<CallToolResult>;
+//# sourceMappingURL=execute-with-wrappers.d.ts.map

package/dist/tools/execute-with-wrappers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-with-wrappers.d.ts","sourceRoot":"","sources":["../../src/tools/execute-with-wrappers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAEnE,OAAO,EAAmB,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;CAwBvC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C,6CAA6C;IAC7C,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,uCAAuC;IACvC,YAAY,CAAC,EAAE,eAAe,CAAC;CAChC;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,wBAAwB,CAU1F;AAiCD;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,UAAU,EAChB,MAAM,GAAE,gCAAqC,IAmB3C,MAAM,wBAAwB,KAC7B,OAAO,CAAC,cAAc,CAAC,CA4F3B"}

package/dist/tools/execute-with-wrappers.js

@@ -0,0 +1,219 @@
+import { generateServerModule } from '../codegen/wrapper-generator.js';
+import { SandboxExecutor } from '../sandbox/index.js';
+import { MCPBridge } from '../bridge/index.js';
+import { DEFAULT_TIMEOUT_MS } from '../types/execution.js';
+/**
+ * MCP Tool definition for execute_code_with_wrappers
+ */
+export const executeCodeWithWrappersTool = {
+    name: 'execute_code_with_wrappers',
+    description: 'Execute TypeScript/JavaScript code with auto-generated typed wrappers for specified MCP servers. ' +
+        'Provides a typed API like github.createIssue({ title: "..." }) instead of raw mcp.callTool().',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            code: {
+                type: 'string',
+                description: 'The TypeScript/JavaScript code to execute',
+            },
+            wrappers: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Array of MCP server names to generate typed wrappers for',
+            },
+            timeout_ms: {
+                type: 'number',
+                description: `Maximum execution time in milliseconds (default: ${DEFAULT_TIMEOUT_MS})`,
+            },
+        },
+        required: ['code', 'wrappers'],
+    },
+};
+/**
+ * Type guard for ExecuteWithWrappersInput
+ */
+export function isExecuteWithWrappersInput(args) {
+    return (typeof args === 'object' &&
+        args !== null &&
+        'code' in args &&
+        typeof args.code === 'string' &&
+        'wrappers' in args &&
+        Array.isArray(args.wrappers) &&
+        args.wrappers.every((w) => typeof w === 'string'));
+}
+/**
+ * Generate the MCP helper preamble that provides the global `mcp` object
+ * for calling MCP tools via the HTTP bridge
+ */
+function getMcpPreamble(bridgePort) {
+    return `
+// MCP helper for calling tools via HTTP bridge
+declare global {
+  var mcp: {
+    callTool: (server: string, tool: string, args?: Record<string, unknown>) => Promise<unknown[]>;
+  };
+}
+
+globalThis.mcp = {
+  callTool: async (server: string, tool: string, args: Record<string, unknown> = {}) => {
+    const response = await fetch('http://localhost:${bridgePort}/call', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ server, tool, args }),
+    });
+    const data = await response.json() as { success: boolean; content?: unknown[]; error?: string };
+    if (!data.success) {
+      throw new Error(data.error || 'MCP tool call failed');
+    }
+    return data.content || [];
+  },
+};
+
+`;
+}
+/**
+ * Creates the execute_code_with_wrappers handler function
+ *
+ * @param pool - Server pool for MCP connections
+ * @param config - Optional handler configuration
+ * @returns Handler function for execute_code_with_wrappers tool
+ */
+export function createExecuteWithWrappersHandler(pool, config = {}) {
+    // Ensure bridge port matches sandbox network config
+    const bridgePort = config.bridgeConfig?.port ?? 3000;
+    const sandboxConfig = {
+        ...config.sandboxConfig,
+        mcpBridgePort: bridgePort,
+    };
+    const executor = new SandboxExecutor(sandboxConfig);
+    const bridge = new MCPBridge(pool, {
+        ...config.bridgeConfig,
+        port: bridgePort,
+    });
+    /**
+     * Execute code with wrappers handler - generates wrappers, composes code, and executes
+     */
+    return async function executeWithWrappersHandler(args) {
+        const { code, wrappers, timeout_ms = DEFAULT_TIMEOUT_MS } = args;
+        // Validate input
+        if (!code || typeof code !== 'string') {
+            return {
+                content: [{ type: 'text', text: 'Error: code parameter is required and must be a string' }],
+                isError: true,
+            };
+        }
+        if (!wrappers || !Array.isArray(wrappers)) {
+            return {
+                content: [{ type: 'text', text: 'Error: wrappers parameter is required and must be an array of strings' }],
+                isError: true,
+            };
+        }
+        if (wrappers.length === 0) {
+            return {
+                content: [{ type: 'text', text: 'Error: wrappers array must contain at least one server name' }],
+                isError: true,
+            };
+        }
+        if (timeout_ms !== undefined && (typeof timeout_ms !== 'number' || timeout_ms <= 0)) {
+            return {
+                content: [{ type: 'text', text: 'Error: timeout_ms must be a positive number' }],
+                isError: true,
+            };
+        }
+        let result = null;
+        try {
+            // Step 1: Generate typed wrappers for each requested server
+            const wrapperModules = [];
+            for (const serverName of wrappers) {
+                try {
+                    // Get connection for this server
+                    const connection = await pool.getConnection(serverName);
+                    // Fetch tools from the server
+                    const tools = await connection.getTools();
+                    // Generate TypeScript module for this server
+                    const moduleCode = generateServerModule(tools, serverName, bridgePort);
+                    wrapperModules.push(moduleCode);
+                    // Release connection back to pool
+                    pool.releaseConnection(serverName);
+                }
+                catch (serverError) {
+                    const errorMessage = serverError instanceof Error ? serverError.message : String(serverError);
+                    return {
+                        content: [{ type: 'text', text: `Error generating wrapper for server '${serverName}': ${errorMessage}` }],
+                        isError: true,
+                    };
+                }
+            }
+            // Step 2: Compose full code with wrappers + MCP preamble + user code
+            const generatedWrappers = wrapperModules.join('\n\n');
+            const mcpPreamble = getMcpPreamble(bridgePort);
+            const fullCode = `${generatedWrappers}\n\n${mcpPreamble}\n${code}`;
+            // Step 3: Start the MCP bridge server
+            await bridge.start();
+            // Step 4: Execute code in sandbox
+            result = await executor.execute(fullCode, timeout_ms);
+            // Step 5: Stop the bridge server
+            await bridge.stop();
+            // Step 6: Format and return result
+            return formatResult(result);
+        }
+        catch (error) {
+            // Ensure bridge is stopped on error
+            try {
+                if (bridge.isRunning()) {
+                    await bridge.stop();
+                }
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            // Return error with any partial output
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return formatErrorResult(errorMessage, result);
+        }
+    };
+}
+/**
+ * Format a successful execution result
+ */
+function formatResult(result) {
+    const lines = [];
+    // Add output
+    if (result.output.length > 0) {
+        lines.push(...result.output);
+    }
+    // Add error if present (non-fatal stderr)
+    if (result.error) {
+        lines.push(`[stderr]: ${result.error}`);
+    }
+    // Add execution time
+    lines.push(`[Execution completed in ${result.durationMs}ms]`);
+    const hasError = !!result.error;
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+        isError: hasError,
+    };
+}
+/**
+ * Format an error result with optional partial output
+ */
+function formatErrorResult(errorMessage, partialResult) {
+    const lines = [];
+    // Add partial output if available
+    if (partialResult?.output.length) {
+        lines.push('[Partial output]:');
+        lines.push(...partialResult.output);
+        lines.push('');
+    }
+    // Add error message
+    lines.push(`Error: ${errorMessage}`);
+    // Add duration if available
+    if (partialResult?.durationMs) {
+        lines.push(`[Execution failed after ${partialResult.durationMs}ms]`);
+    }
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=execute-with-wrappers.js.map

package/dist/tools/execute-with-wrappers.js.map

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

package/dist/tools/get-tool-schema.d.ts

@@ -0,0 +1,59 @@
+/**
+ * get_mcp_tool_schema MCP tool handler
+ * Fetches the schema for a specific MCP tool from a server
+ */
+import { ServerPool } from '@justanothermldude/meta-mcp-core';
+/**
+ * Input type for get_mcp_tool_schema tool
+ */
+export interface GetToolSchemaInput {
+    server: string;
+    tool: string;
+}
+/**
+ * MCP Tool definition for get_mcp_tool_schema
+ */
+export declare const getMcpToolSchemaTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            server: {
+                type: string;
+                description: string;
+            };
+            tool: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * CallToolResult content item
+ */
+export interface TextContent {
+    type: 'text';
+    text: string;
+}
+/**
+ * Standard MCP CallToolResult format
+ */
+export interface CallToolResult {
+    content: TextContent[];
+    isError?: boolean;
+}
+/**
+ * Creates the get_mcp_tool_schema handler function
+ *
+ * @param pool - ServerPool instance for managing connections
+ * @returns Handler function for get_mcp_tool_schema tool
+ */
+export declare function createGetToolSchemaHandler(pool: ServerPool): (args: GetToolSchemaInput) => Promise<CallToolResult>;
+/**
+ * Type guard for GetToolSchemaInput
+ */
+export declare function isGetToolSchemaInput(args: unknown): args is GetToolSchemaInput;
+//# sourceMappingURL=get-tool-schema.d.ts.map

package/dist/tools/get-tool-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-tool-schema.d.ts","sourceRoot":"","sources":["../../src/tools/get-tool-schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAuB,MAAM,kCAAkC,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;CAkBhC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,UAAU,IAKvD,MAAM,kBAAkB,KACvB,OAAO,CAAC,cAAc,CAAC,CA8D3B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,kBAAkB,CAU9E"}