@attrove/mcp 0.1.6 → 0.1.8

package/esm/transport/http.js

@@ -0,0 +1,189 @@
+/**
+ * HTTP Transport for Attrove MCP Server
+ *
+ * Provides HTTP-based transport for the MCP server, enabling AI assistants
+ * like ChatGPT to connect via HTTP endpoints instead of stdio.
+ */
+import { randomUUID } from "node:crypto";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { createServer } from "../server.js";
+/**
+ * Create an HTTP request handler for the MCP server.
+ *
+ * Each call to handleRequest creates new server and transport instances,
+ * providing complete isolation between requests. Callers should create
+ * a new handler when the config (API key/user ID) changes.
+ *
+ * @param config - MCP server configuration with API key and user ID
+ * @param options - Optional handler configuration
+ * @returns Object with handleRequest method for processing HTTP requests
+ *
+ * @example
+ * ```typescript
+ * // In a Fastify route handler
+ * const handler = createHttpHandler({
+ *   apiKey: 'sk_...',
+ *   userId: 'user-uuid',
+ *   baseUrl: 'https://api.attrove.com', // optional, SDK has its own default
+ * });
+ *
+ * // Handle POST request
+ * const result = await handler.handleRequest(req.raw, reply.raw, req.body);
+ * if (!result.handled) {
+ *   // No response sent - caller must send error response
+ *   res.status(500).json({ error: result.error });
+ * }
+ * ```
+ */
+/**
+ * Type guard for Node.js system errors with error codes.
+ */
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+export function createHttpHandler(config, options = {}) {
+    const { enableJsonResponse = true, timeoutMs = 30000 } = options;
+    // Validate timeoutMs to prevent unexpected behavior
+    if (timeoutMs <= 0) {
+        throw new Error("timeoutMs must be a positive number");
+    }
+    return {
+        /**
+         * Handle an incoming HTTP request.
+         *
+         * @param req - Node.js IncomingMessage (or Fastify raw request)
+         * @param res - Node.js ServerResponse (or Fastify raw reply)
+         * @param parsedBody - Pre-parsed request body (optional, Fastify provides this)
+         * @returns Promise resolving to handler result indicating if request was processed
+         */
+        handleRequest: async (req, res, parsedBody) => {
+            let server;
+            let timeoutId;
+            let result;
+            let cleanupFailed = false;
+            let timeoutOccurred = false;
+            // Correlation ID links timeout errors with subsequent suppressed errors for debugging
+            const correlationId = randomUUID().slice(0, 8);
+            try {
+                server = createServer(config);
+                const transport = new StreamableHTTPServerTransport({
+                    sessionIdGenerator: undefined, // Stateless mode - no session tracking needed
+                    enableJsonResponse,
+                });
+                await server.connect(transport);
+                const timeoutPromise = new Promise((_, reject) => {
+                    timeoutId = setTimeout(() => {
+                        timeoutOccurred = true;
+                        reject(new Error(`MCP request timed out after ${timeoutMs}ms`));
+                    }, timeoutMs);
+                });
+                // Store reference to transport promise so we can attach a catch handler.
+                // This prevents unhandled rejection if timeout wins the race and server.close()
+                // later causes the transport to reject.
+                const transportPromise = transport.handleRequest(req, res, parsedBody);
+                // When timeout occurs, Promise.race exits with the timeout error (caught below),
+                // but transportPromise may reject later when server.close() interrupts it.
+                // Only log here if a timeout actually occurred - otherwise Promise.race will
+                // propagate the rejection to the main catch block and logging here would be duplicate.
+                transportPromise.catch((suppressedError) => {
+                    if (!timeoutOccurred) {
+                        // No timeout - Promise.race will handle this rejection via the main catch block
+                        return;
+                    }
+                    const errorMsg = suppressedError instanceof Error
+                        ? suppressedError.message
+                        : String(suppressedError);
+                    // Critical errors that indicate systemic issues (not just slow requests)
+                    const isCritical = /SSL|certificate|ENOTFOUND|ECONNREFUSED|auth/i.test(errorMsg);
+                    const logData = {
+                        level: isCritical ? "error" : "warn",
+                        msg: "MCP transport rejected after timeout - suppressed to prevent unhandled rejection",
+                        errorId: isCritical
+                            ? "MCP_HTTP_SUPPRESSED_CRITICAL_ERROR"
+                            : "MCP_HTTP_SUPPRESSED_POST_TIMEOUT",
+                        correlationId,
+                        error: errorMsg,
+                        userId: config.userId,
+                    };
+                    // prettier-ignore
+                    console.error("[AttroveMCP]", JSON.stringify(logData));
+                });
+                await Promise.race([transportPromise, timeoutPromise]);
+                result = { handled: true };
+            }
+            catch (error) {
+                // Preserve context for non-Error values (e.g., throw "string", throw { code: ... })
+                const message = error instanceof Error
+                    ? error.message
+                    : typeof error === "object" && error !== null
+                        ? `Unknown error: ${JSON.stringify(error)}`
+                        : `Unknown error: ${String(error)}`;
+                const stack = error instanceof Error ? error.stack : undefined;
+                const isTimeout = error instanceof Error && error.message.includes("timed out");
+                // Classify error type for appropriate logging level
+                // Use error.code for socket errors (more precise than string matching)
+                const isSocketError = isNodeError(error) &&
+                    (error.code === "ECONNRESET" ||
+                        error.code === "EPIPE" ||
+                        error.code === "ECONNABORTED");
+                const isExpectedError = isTimeout || isSocketError;
+                // Log with structured JSON for observability (callers should also log via their infrastructure)
+                const errorId = isTimeout
+                    ? "MCP_HTTP_TIMEOUT"
+                    : isSocketError
+                        ? "MCP_HTTP_SOCKET_ERROR"
+                        : "MCP_HTTP_UNEXPECTED_ERROR";
+                const logData = {
+                    level: isExpectedError ? "warn" : "error",
+                    msg: isExpectedError
+                        ? "MCP HTTP handler operational failure"
+                        : "MCP HTTP handler unexpected failure",
+                    errorId,
+                    correlationId,
+                    error: message,
+                    isTimeout,
+                    userId: config.userId,
+                    ...(stack && !isExpectedError && { stack }),
+                    ...(!isExpectedError && { errorType: error?.constructor?.name }),
+                };
+                // prettier-ignore
+                console.error("[AttroveMCP]", JSON.stringify(logData));
+                result = { handled: false, error: message, stack, isTimeout };
+            }
+            finally {
+                // Clear timeout to prevent timer accumulation under load
+                if (timeoutId !== undefined) {
+                    clearTimeout(timeoutId);
+                }
+                if (server) {
+                    try {
+                        await server.close();
+                    }
+                    catch (cleanupError) {
+                        cleanupFailed = true;
+                        // Cleanup failures could indicate resource leaks - always log for monitoring
+                        const cleanupLogData = {
+                            level: "error",
+                            msg: "MCP server cleanup failed - potential resource leak",
+                            errorId: "MCP_CLEANUP_FAILURE",
+                            correlationId,
+                            error: cleanupError instanceof Error
+                                ? cleanupError.message
+                                : String(cleanupError),
+                            stack: cleanupError instanceof Error ? cleanupError.stack : undefined,
+                            userId: config.userId,
+                        };
+                        // prettier-ignore
+                        console.error("[AttroveMCP]", JSON.stringify(cleanupLogData));
+                    }
+                }
+            }
+            // Include cleanup failure warning in success result for monitoring
+            if (result.handled && cleanupFailed) {
+                return { handled: true, cleanupFailed: true };
+            }
+            return result;
+        },
+    };
+}
+//# sourceMappingURL=http.js.map

package/esm/transport/http.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@attrove/mcp",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "MCP server for Attrove - AI-powered context retrieval for Claude and Cursor",
   "type": "module",
   "main": "./cjs/index.js",
@@ -58,7 +58,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "@attrove/sdk": "0.1.6",
+    "@attrove/sdk": "0.1.8",
     "tslib": "^2.6.0"
   },
   "devDependencies": {