mongo.do 0.1.0

package/dist/mcp/sandbox/worker-evaluator.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Worker Loader Evaluator
+ *
+ * Evaluates and loads Cloudflare Worker code in an isolated sandbox.
+ * Uses the Worker Loader API to create isolated V8 contexts with:
+ * - Network isolation (globalOutbound: null)
+ * - Database access through DB_PROXY binding
+ * - Console.log capture
+ * - Timeout enforcement
+ */
+import type { WorkerLoader, WorkerCode } from '../../types/function';
+/**
+ * Result returned from sandbox code execution
+ */
+export interface EvaluatorResult {
+    /** Whether execution succeeded */
+    success: boolean;
+    /** Return value from the code (if success) */
+    value?: unknown;
+    /** Captured console.log output */
+    logs: string[];
+    /** Error message (if !success) */
+    error?: string;
+}
+/**
+ * Interface for database access passed to sandbox
+ */
+export interface DatabaseAccess {
+    /**
+     * Get a service binding/fetcher for the database proxy.
+     * This is passed to the sandbox worker as DB_PROXY.
+     */
+    getProxy(): Fetcher;
+}
+/**
+ * Fetcher interface for service bindings
+ */
+export interface Fetcher {
+    fetch(request: Request | string, init?: RequestInit): Promise<Response>;
+}
+/**
+ * Worker evaluator interface
+ */
+export interface WorkerEvaluator {
+    /** Execute the sandbox code and return results */
+    execute(): Promise<EvaluatorResult>;
+}
+/**
+ * Options for creating a worker evaluator
+ */
+export interface EvaluatorOptions {
+    /** Timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Unique ID for the worker instance */
+    id?: string;
+}
+/**
+ * Create a Worker Loader Evaluator for executing code in an isolated sandbox.
+ *
+ * @param loader - The Worker Loader binding for creating isolated workers
+ * @param dbAccess - Database access provider for DB_PROXY binding
+ * @param code - The user code to execute
+ * @param options - Optional configuration
+ * @returns WorkerEvaluator instance
+ *
+ * @example
+ * ```typescript
+ * const evaluator = createWorkerEvaluator(
+ *   env.LOADER,
+ *   { getProxy: () => env.DATABASE_PROXY },
+ *   'return await db.collection("users").find()'
+ * );
+ * const result = await evaluator.execute();
+ * if (result.success) {
+ *   console.log('Result:', result.value);
+ * }
+ * ```
+ */
+export declare function createWorkerEvaluator(loader: WorkerLoader, dbAccess: DatabaseAccess, code: string, options?: EvaluatorOptions): WorkerEvaluator;
+/**
+ * Create a mock Worker Loader for testing purposes.
+ * This allows testing without actual Worker Loader binding.
+ *
+ * @param mockResults - Map of worker IDs to mock results
+ * @returns Mock WorkerLoader
+ */
+export declare function createMockLoader(mockResults?: Map<string, EvaluatorResult>): {
+    loader: WorkerLoader;
+    getLastConfig: () => Promise<WorkerCode | null>;
+    getCapturedIds: () => string[];
+};
+/**
+ * Create a mock database access for testing.
+ *
+ * @param mockData - Mock data to return from database operations
+ * @returns Mock DatabaseAccess
+ */
+export declare function createMockDbAccess(mockData?: Record<string, unknown[]>): {
+    dbAccess: DatabaseAccess;
+    getCapturedOperations: () => Array<{
+        operation: string;
+        params: unknown;
+    }>;
+};
+/**
+ * Configuration options for Worker Loader evaluator
+ * TODO: Implement in GREEN phase
+ */
+export interface WorkerLoaderConfig {
+    /** Timeout in milliseconds */
+    timeout?: number;
+    /** Custom worker ID */
+    id?: string;
+}
+/**
+ * Security configuration for sandbox isolation
+ * TODO: Implement in GREEN phase
+ */
+export interface SecurityConfig {
+    /** Block all network access (fetch, connect) */
+    blockNetwork: boolean;
+    /** Block file system access */
+    blockFileSystem: boolean;
+    /** Maximum execution time in milliseconds */
+    maxExecutionTime: number;
+    /** Maximum memory usage in bytes */
+    maxMemory: number;
+}
+/**
+ * Extended result with execution duration
+ * TODO: Implement in GREEN phase
+ */
+export interface ExecutionResult {
+    success: boolean;
+    value?: unknown;
+    error?: string;
+    logs: string[];
+    /** Execution duration in milliseconds */
+    duration: number;
+}
+/**
+ * Worker Loader Evaluator class for direct Worker Loader integration
+ * TODO: Implement in GREEN phase
+ */
+export declare class WorkerLoaderEvaluator implements WorkerEvaluator {
+    constructor(_loader: unknown, _dbAccess: DatabaseAccess, _code: string, _config?: WorkerLoaderConfig);
+    execute(): Promise<EvaluatorResult>;
+}
+/**
+ * Create a Worker Loader evaluator with full integration
+ * TODO: Implement in GREEN phase
+ *
+ * @param loader - Worker Loader binding
+ * @param dbAccess - Database access provider
+ * @param code - User code to execute
+ * @param config - Optional configuration
+ * @returns WorkerLoaderEvaluator instance
+ */
+export declare function createWorkerLoaderEvaluator(_loader: unknown, _dbAccess: DatabaseAccess, _code: string, _config?: WorkerLoaderConfig): WorkerLoaderEvaluator;
+//# sourceMappingURL=worker-evaluator.d.ts.map

package/dist/mcp/sandbox/worker-evaluator.d.ts.map

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

package/dist/mcp/sandbox/worker-evaluator.js

@@ -0,0 +1,217 @@
+/**
+ * Worker Loader Evaluator
+ *
+ * Evaluates and loads Cloudflare Worker code in an isolated sandbox.
+ * Uses the Worker Loader API to create isolated V8 contexts with:
+ * - Network isolation (globalOutbound: null)
+ * - Database access through DB_PROXY binding
+ * - Console.log capture
+ * - Timeout enforcement
+ */
+import { randomUUID } from 'crypto';
+import { generateSandboxCode } from './template';
+/**
+ * Create a Worker Loader Evaluator for executing code in an isolated sandbox.
+ *
+ * @param loader - The Worker Loader binding for creating isolated workers
+ * @param dbAccess - Database access provider for DB_PROXY binding
+ * @param code - The user code to execute
+ * @param options - Optional configuration
+ * @returns WorkerEvaluator instance
+ *
+ * @example
+ * ```typescript
+ * const evaluator = createWorkerEvaluator(
+ *   env.LOADER,
+ *   { getProxy: () => env.DATABASE_PROXY },
+ *   'return await db.collection("users").find()'
+ * );
+ * const result = await evaluator.execute();
+ * if (result.success) {
+ *   console.log('Result:', result.value);
+ * }
+ * ```
+ */
+export function createWorkerEvaluator(loader, dbAccess, code, options = {}) {
+    const workerId = options.id ?? `sandbox-${randomUUID()}`;
+    const timeout = options.timeout ?? 30000;
+    return {
+        async execute() {
+            try {
+                // Generate sandbox code that wraps user code
+                const sandboxCode = generateSandboxCode(code);
+                // Get or create the worker with sandbox configuration
+                const worker = loader.get(workerId, async () => ({
+                    compatibilityDate: '2025-06-01',
+                    compatibilityFlags: ['nodejs_compat'],
+                    mainModule: 'sandbox.js',
+                    modules: {
+                        'sandbox.js': sandboxCode
+                    },
+                    env: {
+                        DB_PROXY: dbAccess.getProxy()
+                    },
+                    globalOutbound: null // Block all network access
+                }));
+                // Get the entrypoint and execute with timeout
+                if (!worker.getEntrypoint) {
+                    return {
+                        success: false,
+                        error: 'Worker does not have getEntrypoint method',
+                        logs: [],
+                    };
+                }
+                const entrypoint = worker.getEntrypoint();
+                // Create timeout promise
+                const timeoutPromise = new Promise((_, reject) => {
+                    setTimeout(() => {
+                        reject(new Error(`Sandbox execution timed out after ${timeout}ms`));
+                    }, timeout);
+                });
+                // Execute with timeout race
+                const response = await Promise.race([
+                    entrypoint.fetch(new Request('http://internal/evaluate', {
+                        method: 'POST',
+                        headers: { 'Content-Type': 'application/json' }
+                    })),
+                    timeoutPromise
+                ]);
+                const result = await response.json();
+                const evalResult = {
+                    success: result.success,
+                    logs: result.logs ?? [],
+                };
+                if (result.value !== undefined) {
+                    evalResult.value = result.value;
+                }
+                if (result.error) {
+                    evalResult.error = result.error;
+                }
+                return evalResult;
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: error instanceof Error ? error.message : 'Execution failed',
+                    logs: []
+                };
+            }
+        }
+    };
+}
+/**
+ * Create a mock Worker Loader for testing purposes.
+ * This allows testing without actual Worker Loader binding.
+ *
+ * @param mockResults - Map of worker IDs to mock results
+ * @returns Mock WorkerLoader
+ */
+export function createMockLoader(mockResults = new Map()) {
+    let lastConfig = null;
+    const capturedIds = [];
+    const loader = {
+        get(id, getCode) {
+            capturedIds.push(id);
+            return {
+                getEntrypoint(_name) {
+                    return {
+                        async fetch(_request) {
+                            // Capture the code configuration
+                            lastConfig = await getCode();
+                            // Return mock result if available
+                            const mockResult = mockResults.get(id);
+                            if (mockResult) {
+                                return Response.json(mockResult);
+                            }
+                            // Default success result
+                            return Response.json({
+                                success: true,
+                                value: undefined,
+                                logs: []
+                            });
+                        }
+                    };
+                }
+            };
+        }
+    };
+    return {
+        loader,
+        getLastConfig: async () => lastConfig,
+        getCapturedIds: () => capturedIds
+    };
+}
+/**
+ * Create a mock database access for testing.
+ *
+ * @param mockData - Mock data to return from database operations
+ * @returns Mock DatabaseAccess
+ */
+export function createMockDbAccess(mockData = {}) {
+    const capturedOperations = [];
+    const proxy = {
+        async fetch(request) {
+            const req = typeof request === 'string' ? new Request(request) : request;
+            const url = new URL(req.url);
+            const operation = url.pathname.slice(1); // Remove leading /
+            let params = {};
+            if (req.method === 'POST') {
+                params = await req.json();
+            }
+            capturedOperations.push({ operation, params });
+            // Return mock data based on operation
+            if (operation === 'find') {
+                const p = params;
+                return Response.json(mockData[p.collection] ?? []);
+            }
+            if (operation === 'findOne') {
+                const p = params;
+                const docs = mockData[p.collection] ?? [];
+                return Response.json(docs[0] ?? null);
+            }
+            if (operation === 'countDocuments') {
+                const p = params;
+                return Response.json((mockData[p.collection] ?? []).length);
+            }
+            if (operation === 'listCollections') {
+                return Response.json(Object.keys(mockData));
+            }
+            // Default response for other operations
+            return Response.json({ ok: true });
+        }
+    };
+    const dbAccess = {
+        getProxy: () => proxy
+    };
+    return {
+        dbAccess,
+        getCapturedOperations: () => capturedOperations
+    };
+}
+/**
+ * Worker Loader Evaluator class for direct Worker Loader integration
+ * TODO: Implement in GREEN phase
+ */
+export class WorkerLoaderEvaluator {
+    constructor(_loader, _dbAccess, _code, _config) {
+        // Stub - not implemented
+    }
+    async execute() {
+        throw new Error('WorkerLoaderEvaluator not implemented');
+    }
+}
+/**
+ * Create a Worker Loader evaluator with full integration
+ * TODO: Implement in GREEN phase
+ *
+ * @param loader - Worker Loader binding
+ * @param dbAccess - Database access provider
+ * @param code - User code to execute
+ * @param config - Optional configuration
+ * @returns WorkerLoaderEvaluator instance
+ */
+export function createWorkerLoaderEvaluator(_loader, _dbAccess, _code, _config) {
+    // Stub - not implemented
+    throw new Error('createWorkerLoaderEvaluator not implemented');
+}
+//# sourceMappingURL=worker-evaluator.js.map

package/dist/mcp/sandbox/worker-evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-evaluator.js","sourceRoot":"","sources":["../../../src/mcp/sandbox/worker-evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAqDhD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAoB,EACpB,QAAwB,EACxB,IAAY,EACZ,UAA4B,EAAE;IAE9B,MAAM,QAAQ,GAAG,OAAO,CAAC,EAAE,IAAI,WAAW,UAAU,EAAE,EAAE,CAAA;IACxD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,KAAK,CAAA;IAExC,OAAO;QACL,KAAK,CAAC,OAAO;YACX,IAAI,CAAC;gBACH,6CAA6C;gBAC7C,MAAM,WAAW,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAA;gBAE7C,sDAAsD;gBACtD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,IAAyB,EAAE,CAAC,CAAC;oBACpE,iBAAiB,EAAE,YAAY;oBAC/B,kBAAkB,EAAE,CAAC,eAAe,CAAC;oBACrC,UAAU,EAAE,YAAY;oBACxB,OAAO,EAAE;wBACP,YAAY,EAAE,WAAW;qBAC1B;oBACD,GAAG,EAAE;wBACH,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;qBAC9B;oBACD,cAAc,EAAE,IAAI,CAAC,2BAA2B;iBACjD,CAAC,CAAC,CAAA;gBAEH,8CAA8C;gBAC9C,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;oBAC1B,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,2CAA2C;wBAClD,IAAI,EAAE,EAAE;qBACT,CAAA;gBACH,CAAC;gBACD,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,EAAE,CAAA;gBAEzC,yBAAyB;gBACzB,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;oBACtD,UAAU,CAAC,GAAG,EAAE;wBACd,MAAM,CAAC,IAAI,KAAK,CAAC,qCAAqC,OAAO,IAAI,CAAC,CAAC,CAAA;oBACrE,CAAC,EAAE,OAAO,CAAC,CAAA;gBACb,CAAC,CAAC,CAAA;gBAEF,4BAA4B;gBAC5B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;oBAClC,UAAU,CAAC,KAAK,CACd,IAAI,OAAO,CAAC,0BAA0B,EAAE;wBACtC,MAAM,EAAE,MAAM;wBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;qBAChD,CAAC,CACH;oBACD,cAAc;iBACf,CAAC,CAAA;gBAEF,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAqB,CAAA;gBAEvD,MAAM,UAAU,GAAoB;oBAClC,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;iBACxB,CAAA;gBACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;oBAC/B,UAAU,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;gBACjC,CAAC;gBACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;oBACjB,UAAU,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;gBACjC,CAAC;gBACD,OAAO,UAAU,CAAA;YACnB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB;oBAClE,IAAI,EAAE,EAAE;iBACT,CAAA;YACH,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,cAA4C,IAAI,GAAG,EAAE;IAKpF,IAAI,UAAU,GAAsB,IAAI,CAAA;IACxC,MAAM,WAAW,GAAa,EAAE,CAAA;IAEhC,MAAM,MAAM,GAAiB;QAC3B,GAAG,CAAC,EAAU,EAAE,OAAkC;YAChD,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAEpB,OAAO;gBACL,aAAa,CAAC,KAAc;oBAC1B,OAAO;wBACL,KAAK,CAAC,KAAK,CAAC,QAAiB;4BAC3B,iCAAiC;4BACjC,UAAU,GAAG,MAAM,OAAO,EAAE,CAAA;4BAE5B,kCAAkC;4BAClC,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;4BACtC,IAAI,UAAU,EAAE,CAAC;gCACf,OAAO,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;4BAClC,CAAC;4BAED,yBAAyB;4BACzB,OAAO,QAAQ,CAAC,IAAI,CAAC;gCACnB,OAAO,EAAE,IAAI;gCACb,KAAK,EAAE,SAAS;gCAChB,IAAI,EAAE,EAAE;6BACT,CAAC,CAAA;wBACJ,CAAC;qBACF,CAAA;gBACH,CAAC;aACF,CAAA;QACH,CAAC;KACF,CAAA;IAED,OAAO;QACL,MAAM;QACN,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC,UAAU;QACrC,cAAc,EAAE,GAAG,EAAE,CAAC,WAAW;KAClC,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAsC,EAAE;IAIzE,MAAM,kBAAkB,GAAkD,EAAE,CAAA;IAE5E,MAAM,KAAK,GAAY;QACrB,KAAK,CAAC,KAAK,CAAC,OAAyB;YACnC,MAAM,GAAG,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;YACxE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YAC5B,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA,CAAC,mBAAmB;YAE3D,IAAI,MAAM,GAAG,EAAE,CAAA;YACf,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC1B,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;YAC3B,CAAC;YAED,kBAAkB,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAA;YAE9C,sCAAsC;YACtC,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;gBACzB,MAAM,CAAC,GAAG,MAAgC,CAAA;gBAC1C,OAAO,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAA;YACpD,CAAC;YACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,MAAM,CAAC,GAAG,MAAgC,CAAA;gBAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAA;gBACzC,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAA;YACvC,CAAC;YACD,IAAI,SAAS,KAAK,gBAAgB,EAAE,CAAC;gBACnC,MAAM,CAAC,GAAG,MAAgC,CAAA;gBAC1C,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAA;YAC7D,CAAC;YACD,IAAI,SAAS,KAAK,iBAAiB,EAAE,CAAC;gBACpC,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;YAC7C,CAAC;YAED,wCAAwC;YACxC,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;QACpC,CAAC;KACF,CAAA;IAED,MAAM,QAAQ,GAAmB;QAC/B,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK;KACtB,CAAA;IAED,OAAO;QACL,QAAQ;QACR,qBAAqB,EAAE,GAAG,EAAE,CAAC,kBAAkB;KAChD,CAAA;AACH,CAAC;AA6CD;;;GAGG;AACH,MAAM,OAAO,qBAAqB;IAChC,YACE,OAAgB,EAChB,SAAyB,EACzB,KAAa,EACb,OAA4B;QAE5B,yBAAyB;IAC3B,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;IAC1D,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAAgB,EAChB,SAAyB,EACzB,KAAa,EACb,OAA4B;IAE5B,yBAAyB;IACzB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;AAChE,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,75 @@
+/**
+ * MCP Server Factory for mongo.do
+ *
+ * Creates MCP server instances that provide:
+ * - search: Query documents (readonly)
+ * - fetch: Retrieve full documents by ID (readonly)
+ * - do: Execute secure arbitrary code via Worker Loader sandbox (when loader available)
+ */
+import type { McpToolDefinition, McpToolHandler, McpToolResponse, McpRegisteredTool, McpRequest, McpResponse } from './types';
+export type { DatabaseAccess } from './types';
+/**
+ * Code loader interface for executing JavaScript code in a sandbox
+ */
+export interface CodeLoader {
+    execute(code: string, context?: Record<string, unknown>): Promise<{
+        success: boolean;
+        result?: unknown;
+        error?: string;
+    }>;
+}
+/**
+ * Configuration for creating an MCP server
+ */
+export interface McpServerConfig {
+    /** Database access interface for tool implementations */
+    dbAccess: DatabaseAccess;
+    /** Optional code loader for secure code execution (enables 'do' tool) */
+    codeLoader?: CodeLoader;
+    /** Server name (default: 'mongo.do') */
+    name?: string;
+    /** Server version (default: '1.0.0') */
+    version?: string;
+}
+/**
+ * MCP Server instance
+ */
+export interface McpServer {
+    /** Server name */
+    readonly name: string;
+    /** Server version */
+    readonly version: string;
+    /**
+     * Register a tool with the server
+     */
+    tool<T extends Record<string, unknown>>(name: string, inputSchema: McpToolDefinition['inputSchema'], handler: McpToolHandler<T>, annotations?: McpToolDefinition['annotations']): void;
+    /**
+     * Register a tool with definition and handler
+     */
+    registerTool(tool: McpRegisteredTool): void;
+    /**
+     * List all registered tools
+     */
+    listTools(): Promise<McpToolDefinition[]>;
+    /**
+     * Call a tool by name
+     */
+    callTool(name: string, args: Record<string, unknown>): Promise<McpToolResponse>;
+    /**
+     * Handle an incoming MCP request (JSON-RPC)
+     */
+    handleRequest(request: McpRequest): Promise<McpResponse>;
+}
+import type { DatabaseAccess } from './types';
+/**
+ * Create an MCP server instance for mongo.do
+ *
+ * @param config - Server configuration including database access and optional code loader
+ * @returns Configured MCP server instance
+ */
+export declare function createMcpServer(config: McpServerConfig): McpServer;
+/**
+ * Create a mock DatabaseAccess for testing
+ */
+export declare function createMockDatabaseAccess(): DatabaseAccess;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,WAAW,EAGZ,MAAM,SAAS,CAAA;AAGhB,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC1H;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,QAAQ,EAAE,cAAc,CAAA;IACxB,yEAAyE;IACzE,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,kBAAkB;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,qBAAqB;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAExB;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,iBAAiB,CAAC,aAAa,CAAC,EAC7C,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAC1B,WAAW,CAAC,EAAE,iBAAiB,CAAC,aAAa,CAAC,GAC7C,IAAI,CAAA;IAEP;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAE3C;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAA;IAEzC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAE/E;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;CACzD;AAGD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAyPlE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,cAAc,CA0CzD"}