mongo.do 0.1.0

package/dist/mcp/tools/search.js

@@ -0,0 +1,278 @@
+/**
+ * Search Tool for MCP Server
+ *
+ * Implements document search functionality following OpenAI Deep Research format.
+ * Supports JSON filters, collection-prefixed queries, and natural language search.
+ */
+/** Maximum number of results to return */
+const MAX_RESULTS = 100;
+/** Maximum length for preview text */
+const MAX_PREVIEW_LENGTH = 500;
+/** Default database name if not specified */
+const DEFAULT_DATABASE = 'default';
+/**
+ * Search tool implementation
+ *
+ * @param dbAccess - Database access interface
+ * @param query - Search query (JSON filter, collection:query, or natural language)
+ * @param options - Optional search options
+ * @returns MCP tool response with search results
+ */
+export async function searchTool(dbAccess, query, options = {}) {
+    try {
+        const { collection, filter, database } = parseQuery(query, options);
+        const limit = options.limit ?? MAX_RESULTS;
+        // Execute search
+        const documents = await executeSearch(dbAccess, collection ?? options.collection, filter, limit);
+        // Format results to OpenAI Deep Research standard
+        const results = documents.slice(0, limit).map((doc) => formatSearchResult(doc, doc._collection ?? collection ?? options.collection ?? 'unknown', doc._database ?? database ?? options.database ?? DEFAULT_DATABASE));
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ results }),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: error instanceof Error ? error.message : 'Search failed',
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+/**
+ * Parse a search query into collection, filter, and database
+ */
+function parseQuery(query, options = {}) {
+    const trimmedQuery = query.trim();
+    // Try to parse as JSON filter first
+    if (trimmedQuery.startsWith('{')) {
+        try {
+            const filter = JSON.parse(trimmedQuery);
+            const result = {
+                filter,
+                database: options.database ?? DEFAULT_DATABASE,
+            };
+            if (options.collection) {
+                result.collection = options.collection;
+            }
+            return result;
+        }
+        catch {
+            // Fall through to other parsing methods
+        }
+    }
+    // Try db.collection: query format
+    const dbCollMatch = trimmedQuery.match(/^(\w+)\.(\w+):\s*(.+)$/);
+    if (dbCollMatch) {
+        const dbName = dbCollMatch[1];
+        const collName = dbCollMatch[2];
+        const queryPart = dbCollMatch[3];
+        return {
+            database: dbName,
+            collection: collName,
+            filter: parseSimpleQuery(queryPart),
+        };
+    }
+    // Try collection: query format
+    const colonMatch = trimmedQuery.match(/^(\w+):\s*(.+)$/);
+    if (colonMatch) {
+        const collName = colonMatch[1];
+        const queryPart = colonMatch[2];
+        return {
+            collection: collName,
+            filter: parseSimpleQuery(queryPart),
+            database: options.database ?? DEFAULT_DATABASE,
+        };
+    }
+    // Treat as natural language - search all text fields
+    const result = {
+        filter: { $text: { $search: trimmedQuery } },
+        database: options.database ?? DEFAULT_DATABASE,
+    };
+    if (options.collection) {
+        result.collection = options.collection;
+    }
+    return result;
+}
+/**
+ * Parse simple field = value query syntax
+ */
+function parseSimpleQuery(query) {
+    const trimmed = query.trim();
+    // Handle "field = value" syntax
+    const eqMatch = trimmed.match(/^(\w+)\s*=\s*(.+)$/);
+    if (eqMatch) {
+        const field = eqMatch[1];
+        let value = eqMatch[2].trim();
+        // Remove quotes if present
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        // Try to parse as number
+        const numValue = Number(value);
+        if (!isNaN(numValue) && value === String(numValue)) {
+            return { [field]: numValue };
+        }
+        return { [field]: value };
+    }
+    // Default to text search
+    return { $text: { $search: trimmed } };
+}
+/**
+ * Execute search against database
+ */
+async function executeSearch(dbAccess, collection, filter, limit) {
+    const searchOptions = { limit };
+    if (collection) {
+        try {
+            return (await dbAccess.find(collection, filter, searchOptions));
+        }
+        catch (error) {
+            // If $text search fails (index not available), try regex fallback
+            if (error instanceof Error &&
+                (error.message.includes('$text') || error.message.includes('text index'))) {
+                return executeRegexFallback(dbAccess, collection, filter, searchOptions);
+            }
+            throw error;
+        }
+    }
+    // Search all collections if none specified
+    const collections = await dbAccess.listCollections();
+    const allResults = [];
+    let lastError = null;
+    // Limit to first 10 collections to prevent overwhelming searches
+    for (const coll of collections.slice(0, 10)) {
+        if (allResults.length >= limit)
+            break;
+        try {
+            const docs = (await dbAccess.find(coll, filter, {
+                limit: limit - allResults.length,
+            }));
+            allResults.push(...docs.map((d) => ({
+                ...d,
+                _collection: coll,
+            })));
+        }
+        catch (error) {
+            // Track the last error - if all collections fail, we should report it
+            lastError = error instanceof Error ? error : new Error(String(error));
+            continue;
+        }
+    }
+    // If we got no results and had errors, throw the last error
+    if (allResults.length === 0 && lastError) {
+        throw lastError;
+    }
+    return allResults;
+}
+/**
+ * Fallback to regex search when $text search is not available
+ */
+async function executeRegexFallback(dbAccess, collection, filter, options) {
+    const textFilter = filter;
+    if (!textFilter.$text?.$search) {
+        return (await dbAccess.find(collection, filter, options));
+    }
+    const searchTerm = textFilter.$text.$search;
+    const regexFilter = {
+        $or: [
+            { name: { $regex: searchTerm, $options: 'i' } },
+            { title: { $regex: searchTerm, $options: 'i' } },
+            { description: { $regex: searchTerm, $options: 'i' } },
+            { content: { $regex: searchTerm, $options: 'i' } },
+        ],
+    };
+    return (await dbAccess.find(collection, regexFilter, options));
+}
+/**
+ * Format a document as a SearchResult
+ */
+function formatSearchResult(doc, collection, database) {
+    const id = doc._id?.toString() ?? 'unknown';
+    return {
+        id: `${database}.${collection}.${id}`,
+        title: getDocumentTitle(doc),
+        url: `mongodb://${database}/${collection}/${id}`,
+        text: createPreview(doc),
+    };
+}
+/**
+ * Get a human-readable title for a document
+ */
+function getDocumentTitle(doc) {
+    // Try common title fields
+    if (typeof doc.title === 'string' && doc.title) {
+        return doc.title;
+    }
+    if (typeof doc.name === 'string' && doc.name) {
+        return doc.name;
+    }
+    // Fall back to _id
+    if (doc._id) {
+        return doc._id.toString();
+    }
+    return 'Untitled';
+}
+/**
+ * Create a preview text snippet from a document
+ */
+function createPreview(doc) {
+    // Create a clean copy without internal fields
+    const cleanDoc = { ...doc };
+    delete cleanDoc._collection;
+    delete cleanDoc._database;
+    const preview = JSON.stringify(cleanDoc, null, 2);
+    if (preview.length > MAX_PREVIEW_LENGTH) {
+        return preview.slice(0, MAX_PREVIEW_LENGTH - 3) + '...';
+    }
+    return preview;
+}
+/**
+ * MCP Tool Definition for search
+ */
+export const searchToolDefinition = {
+    name: 'search',
+    description: 'Search for documents in MondoDB. Supports JSON filters, collection:query format, or natural language queries. Returns results in OpenAI Deep Research format.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Search query. Can be: JSON filter (e.g., {"name": "Alice"}), collection:query format (e.g., users: name = Alice), or natural language (e.g., find users named Alice)',
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of results to return (default: 100, max: 100)',
+            },
+            collection: {
+                type: 'string',
+                description: 'Specific collection to search in. Optional.',
+            },
+            database: {
+                type: 'string',
+                description: 'Database name. Optional, defaults to "default".',
+            },
+        },
+        required: ['query'],
+    },
+    annotations: {
+        title: 'Search Documents',
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+};
+export default searchTool;
+//# sourceMappingURL=search.js.map

package/dist/mcp/tools/search.js.map

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

package/dist/mcp/transport/http.d.ts

@@ -0,0 +1,144 @@
+/**
+ * HTTP Transport for MCP Server
+ *
+ * Provides HTTP/SSE transport for MCP protocol:
+ * - POST for JSON-RPC requests
+ * - GET for SSE streams
+ * - OPTIONS for CORS preflight
+ * - Session management via mcp-session-id header
+ * - Request logging callback
+ * - Authentication hook
+ * - Rate limiting
+ */
+import type { McpServer } from '../server';
+/**
+ * CORS configuration options
+ */
+export interface CorsOptions {
+    /** Allowed origins (default: '*') */
+    origin?: string | string[];
+    /** Allowed methods (default: 'GET, POST, OPTIONS') */
+    methods?: string;
+    /** Allowed headers (default: 'Content-Type, mcp-session-id') */
+    allowedHeaders?: string;
+    /** Exposed headers (default: 'mcp-session-id') */
+    exposedHeaders?: string;
+    /** Max age for preflight cache in seconds (default: 86400) */
+    maxAge?: number;
+    /** Allow credentials (default: false) */
+    credentials?: boolean;
+}
+/**
+ * Request log entry for logging callback
+ */
+export interface RequestLogEntry {
+    /** Timestamp of the request */
+    timestamp: Date;
+    /** HTTP method */
+    method: string;
+    /** Request URL */
+    url: string;
+    /** Session ID if available */
+    sessionId?: string;
+    /** Response status code */
+    statusCode: number;
+    /** Duration in milliseconds */
+    durationMs: number;
+    /** JSON-RPC method if applicable */
+    rpcMethod?: string;
+    /** Error message if request failed */
+    error?: string;
+}
+/**
+ * Request logging callback function
+ */
+export type RequestLogCallback = (entry: RequestLogEntry) => void;
+/**
+ * Authentication result
+ */
+export interface AuthResult {
+    /** Whether authentication succeeded */
+    authenticated: boolean;
+    /** Error message if authentication failed */
+    error?: string;
+    /** Optional user/client identifier */
+    identity?: string;
+}
+/**
+ * Authentication hook function
+ */
+export type AuthHook = (request: Request) => Promise<AuthResult> | AuthResult;
+/**
+ * Rate limit result
+ */
+export interface RateLimitResult {
+    /** Whether the request is allowed */
+    allowed: boolean;
+    /** Retry-After header value in seconds (if rate limited) */
+    retryAfter?: number;
+    /** Remaining requests in current window */
+    remaining?: number;
+    /** Total limit for the window */
+    limit?: number;
+    /** When the rate limit window resets (Unix timestamp) */
+    resetAt?: number;
+}
+/**
+ * Rate limiting options
+ */
+export interface RateLimitOptions {
+    /** Maximum requests per window */
+    maxRequests: number;
+    /** Window size in milliseconds */
+    windowMs: number;
+    /** Key extractor function (default: IP-based or session-based) */
+    keyExtractor?: (request: Request, sessionId?: string) => string;
+    /** Custom rate limit check function (overrides built-in limiter) */
+    customLimiter?: (key: string, request: Request) => Promise<RateLimitResult> | RateLimitResult;
+}
+/**
+ * HTTP transport options
+ */
+export interface HttpTransportOptions {
+    /** CORS configuration */
+    cors?: CorsOptions;
+    /** Request logging callback */
+    onRequest?: RequestLogCallback;
+    /** Authentication hook */
+    authenticate?: AuthHook;
+    /** Rate limiting configuration */
+    rateLimit?: RateLimitOptions;
+}
+/**
+ * HTTP handler function type
+ */
+export type HttpHandler = (request: Request) => Promise<Response>;
+/**
+ * SSE session for managing server-sent events
+ */
+interface SseSession {
+    controller: ReadableStreamDefaultController<Uint8Array>;
+    encoder: TextEncoder;
+    lastEventId: number;
+}
+/**
+ * Session storage for managing MCP sessions
+ */
+interface SessionStore {
+    /** SSE sessions for real-time streaming */
+    sseClients: Map<string, SseSession>;
+    /** Last activity timestamp for session cleanup */
+    lastActivity: Map<string, number>;
+}
+export declare function createHttpMcpHandler(server: McpServer, corsOptionsOrOptions?: CorsOptions | HttpTransportOptions): HttpHandler;
+/**
+ * Send an event to a specific SSE session
+ */
+export declare function sendSseEvent(sessionId: string, sessions: SessionStore, event: string, data: unknown): boolean;
+/**
+ * Create a simple request handler that wraps the MCP handler
+ * for use with standard HTTP servers
+ */
+export declare function createStandardHandler(server: McpServer, corsOptions?: CorsOptions): HttpHandler;
+export {};
+//# sourceMappingURL=http.d.ts.map

package/dist/mcp/transport/http.d.ts.map

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