@arvoretech/runtime-lens-mcp 1.0.0

package/dist/runtime-interceptor.js

@@ -0,0 +1,133 @@
+const LEVEL_MAP = {
+    log: "info",
+    info: "info",
+    warn: "warn",
+    error: "error",
+    debug: "debug",
+};
+export class RuntimeInterceptor {
+    originalConsole = {};
+    intercepting = false;
+    collector;
+    framework;
+    constructor(collector, framework = "unknown") {
+        this.collector = collector;
+        this.framework = framework;
+    }
+    startIntercepting() {
+        if (this.intercepting)
+            return;
+        const methods = ["log", "info", "warn", "error", "debug"];
+        for (const method of methods) {
+            this.originalConsole[method] = console[method].bind(console);
+            console[method] = (...args) => {
+                this.collector.addLog({
+                    level: LEVEL_MAP[method],
+                    message: args.map((a) => this.serialize(a)).join(" "),
+                    source: "console",
+                    framework: this.framework,
+                    stackTrace: method === "error" ? this.captureStack() : undefined,
+                    metadata: args.length === 1 && typeof args[0] === "object" ? args[0] : undefined,
+                });
+                this.originalConsole[method](...args);
+            };
+        }
+        this.interceptStderr();
+        this.interceptUncaughtErrors();
+        this.intercepting = true;
+    }
+    stopIntercepting() {
+        if (!this.intercepting)
+            return;
+        const methods = ["log", "info", "warn", "error", "debug"];
+        for (const method of methods) {
+            if (this.originalConsole[method]) {
+                console[method] = this.originalConsole[method];
+            }
+        }
+        this.intercepting = false;
+    }
+    isActive() {
+        return this.intercepting;
+    }
+    interceptStderr() {
+        const originalWrite = process.stderr.write.bind(process.stderr);
+        process.stderr.write = ((chunk, encodingOrCallback, callback) => {
+            const text = typeof chunk === "string" ? chunk : chunk.toString();
+            if (text.trim() && !text.includes("MCP Server")) {
+                this.collector.addLog({
+                    level: this.inferLevel(text),
+                    message: text.trim(),
+                    source: "stderr",
+                    framework: this.framework,
+                    stackTrace: text.includes("Error") ? text : undefined,
+                });
+            }
+            if (typeof encodingOrCallback === "function") {
+                return originalWrite(chunk, encodingOrCallback);
+            }
+            return originalWrite(chunk, encodingOrCallback, callback);
+        });
+    }
+    interceptUncaughtErrors() {
+        process.on("uncaughtException", (error) => {
+            this.collector.addLog({
+                level: "fatal",
+                message: error.message,
+                source: "uncaughtException",
+                framework: this.framework,
+                stackTrace: error.stack,
+                metadata: { name: error.name },
+            });
+        });
+        process.on("unhandledRejection", (reason) => {
+            this.collector.addLog({
+                level: "error",
+                message: reason instanceof Error ? reason.message : String(reason),
+                source: "unhandledRejection",
+                framework: this.framework,
+                stackTrace: reason instanceof Error ? reason.stack : undefined,
+            });
+        });
+    }
+    serialize(value) {
+        if (value === null)
+            return "null";
+        if (value === undefined)
+            return "undefined";
+        if (typeof value === "string")
+            return value;
+        if (value instanceof Error)
+            return `${value.name}: ${value.message}\n${value.stack}`;
+        if (typeof value === "object") {
+            try {
+                return JSON.stringify(value, null, 2);
+            }
+            catch {
+                return Object.prototype.toString.call(value);
+            }
+        }
+        return String(value);
+    }
+    captureStack() {
+        const stack = new Error().stack || "";
+        return stack
+            .split("\n")
+            .slice(3)
+            .filter((line) => !line.includes("runtime-interceptor"))
+            .join("\n");
+    }
+    inferLevel(text) {
+        const lower = text.toLowerCase();
+        if (lower.includes("fatal") || lower.includes("critical"))
+            return "fatal";
+        if (lower.includes("error"))
+            return "error";
+        if (lower.includes("warn"))
+            return "warn";
+        if (lower.includes("debug") || lower.includes("verbose"))
+            return "debug";
+        return "info";
+    }
+}
+//# sourceMappingURL=runtime-interceptor.js.map

package/dist/runtime-interceptor.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,26 @@
+export declare class RuntimeLensMCPServer {
+    private readonly server;
+    private readonly collector;
+    private readonly inspector;
+    private readonly interceptor;
+    constructor(projectRoot?: string, logPaths?: string[]);
+    static fromEnvironment(): RuntimeLensMCPServer;
+    private setupTools;
+    private registerTailLogs;
+    private registerSearchLogs;
+    private registerGetErrors;
+    private registerInspectRequests;
+    private registerGetPerformance;
+    private registerGetEnvInfo;
+    private registerClearLogs;
+    private registerGetStats;
+    private registerStartInterceptor;
+    private registerStopInterceptor;
+    private registerCollectLogs;
+    private registerScanProject;
+    private registerFindProcesses;
+    private registerGetPorts;
+    start(): Promise<void>;
+    setupGracefulShutdown(): void;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAaA,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;gBAErC,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE;IAarD,MAAM,CAAC,eAAe,IAAI,oBAAoB;IAM9C,OAAO,CAAC,UAAU;IAiBlB,OAAO,CAAC,gBAAgB;IAyBxB,OAAO,CAAC,kBAAkB;IA0B1B,OAAO,CAAC,iBAAiB;IAwBzB,OAAO,CAAC,uBAAuB;IA0B/B,OAAO,CAAC,sBAAsB;IAyB9B,OAAO,CAAC,kBAAkB;IAoB1B,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,wBAAwB;IAoBhC,OAAO,CAAC,uBAAuB;IAoB/B,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,mBAAmB;IAoB3B,OAAO,CAAC,qBAAqB;IAoB7B,OAAO,CAAC,gBAAgB;IAoBlB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5B,qBAAqB,IAAI,IAAI;CAU9B"}

package/dist/server.js

@@ -0,0 +1,301 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { LogCollector } from "./log-collector.js";
+import { ProcessInspector } from "./process-inspector.js";
+import { RuntimeInterceptor } from "./runtime-interceptor.js";
+import { TailLogsParamsSchema, SearchLogsParamsSchema, GetErrorsParamsSchema, InspectRequestParamsSchema, GetPerformanceParamsSchema, } from "./types.js";
+export class RuntimeLensMCPServer {
+    server;
+    collector;
+    inspector;
+    interceptor;
+    constructor(projectRoot, logPaths) {
+        this.server = new McpServer({
+            name: "runtime-lens-mcp",
+            version: "1.0.0",
+        });
+        this.collector = new LogCollector(projectRoot, logPaths);
+        this.inspector = new ProcessInspector(projectRoot);
+        this.interceptor = new RuntimeInterceptor(this.collector);
+        this.setupTools();
+    }
+    static fromEnvironment() {
+        const projectRoot = process.env.RUNTIME_LENS_PROJECT_ROOT || process.cwd();
+        const logPaths = process.env.RUNTIME_LENS_LOG_PATHS?.split(",").filter(Boolean) || [];
+        return new RuntimeLensMCPServer(projectRoot, logPaths);
+    }
+    setupTools() {
+        this.registerTailLogs();
+        this.registerSearchLogs();
+        this.registerGetErrors();
+        this.registerInspectRequests();
+        this.registerGetPerformance();
+        this.registerGetEnvInfo();
+        this.registerClearLogs();
+        this.registerGetStats();
+        this.registerStartInterceptor();
+        this.registerStopInterceptor();
+        this.registerCollectLogs();
+        this.registerScanProject();
+        this.registerFindProcesses();
+        this.registerGetPorts();
+    }
+    registerTailLogs() {
+        this.server.registerTool("tail_logs", {
+            title: "Tail Logs",
+            description: "Retrieve recent log entries from the application buffer. Supports filtering by level, framework, and source.",
+            inputSchema: {
+                lines: TailLogsParamsSchema.shape.lines,
+                level: TailLogsParamsSchema.shape.level,
+                framework: TailLogsParamsSchema.shape.framework,
+                source: TailLogsParamsSchema.shape.source,
+            },
+        }, async (params) => {
+            const logs = this.collector.getLogs(params);
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify(logs, null, 2),
+                    }],
+            };
+        });
+    }
+    registerSearchLogs() {
+        this.server.registerTool("search_logs", {
+            title: "Search Logs",
+            description: "Search through collected logs using regex patterns. Filter by level, framework, and time range.",
+            inputSchema: {
+                query: SearchLogsParamsSchema.shape.query,
+                level: SearchLogsParamsSchema.shape.level,
+                framework: SearchLogsParamsSchema.shape.framework,
+                limit: SearchLogsParamsSchema.shape.limit,
+                since: SearchLogsParamsSchema.shape.since,
+            },
+        }, async (params) => {
+            const logs = this.collector.searchLogs(params);
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify(logs, null, 2),
+                    }],
+            };
+        });
+    }
+    registerGetErrors() {
+        this.server.registerTool("get_errors", {
+            title: "Get Errors",
+            description: "Retrieve recent errors with stack traces. Optionally group similar errors together to identify patterns.",
+            inputSchema: {
+                limit: GetErrorsParamsSchema.shape.limit,
+                framework: GetErrorsParamsSchema.shape.framework,
+                grouped: GetErrorsParamsSchema.shape.grouped,
+            },
+        }, async (params) => {
+            const errors = this.collector.getErrors(params);
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify(errors, null, 2),
+                    }],
+            };
+        });
+    }
+    registerInspectRequests() {
+        this.server.registerTool("inspect_requests", {
+            title: "Inspect HTTP Requests",
+            description: "Inspect captured HTTP requests and responses. Filter by method, URL pattern, status code, or specific request ID.",
+            inputSchema: {
+                id: InspectRequestParamsSchema.shape.id,
+                method: InspectRequestParamsSchema.shape.method,
+                urlPattern: InspectRequestParamsSchema.shape.urlPattern,
+                statusCode: InspectRequestParamsSchema.shape.statusCode,
+                limit: InspectRequestParamsSchema.shape.limit,
+            },
+        }, async (params) => {
+            const requests = this.collector.getRequests(params);
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify(requests, null, 2),
+                    }],
+            };
+        });
+    }
+    registerGetPerformance() {
+        this.server.registerTool("get_performance", {
+            title: "Get Performance Metrics",
+            description: "Retrieve performance metrics including memory usage, CPU, and custom metrics from the application.",
+            inputSchema: {
+                metric: GetPerformanceParamsSchema.shape.metric,
+                since: GetPerformanceParamsSchema.shape.since,
+                limit: GetPerformanceParamsSchema.shape.limit,
+            },
+        }, async (params) => {
+            await this.collector.collectFromProcess();
+            const metrics = this.collector.getMetrics(params);
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify(metrics, null, 2),
+                    }],
+            };
+        });
+    }
+    registerGetEnvInfo() {
+        this.server.registerTool("get_env_info", {
+            title: "Get Environment Info",
+            description: "Get comprehensive environment information including running Node.js processes, listening ports, project framework detection, and system resources.",
+            inputSchema: {},
+        }, async () => {
+            const info = await this.inspector.getEnvironmentInfo();
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify(info, null, 2),
+                    }],
+            };
+        });
+    }
+    registerClearLogs() {
+        this.server.registerTool("clear_logs", {
+            title: "Clear Log Buffer",
+            description: "Clear all collected logs, requests, and metrics from the buffer.",
+            inputSchema: {},
+        }, async () => {
+            const result = this.collector.clearLogs();
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({ message: `Cleared ${result.cleared} entries` }),
+                    }],
+            };
+        });
+    }
+    registerGetStats() {
+        this.server.registerTool("get_stats", {
+            title: "Get Log Statistics",
+            description: "Get statistics about collected logs including counts by level and framework.",
+            inputSchema: {},
+        }, async () => {
+            const stats = this.collector.getStats();
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify(stats, null, 2),
+                    }],
+            };
+        });
+    }
+    registerStartInterceptor() {
+        this.server.registerTool("start_interceptor", {
+            title: "Start Console Interceptor",
+            description: "Start intercepting console.log/warn/error/debug calls and stderr output in real-time. Captured output is stored in the log buffer.",
+            inputSchema: {},
+        }, async () => {
+            this.interceptor.startIntercepting();
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({ message: "Console interceptor started", active: true }),
+                    }],
+            };
+        });
+    }
+    registerStopInterceptor() {
+        this.server.registerTool("stop_interceptor", {
+            title: "Stop Console Interceptor",
+            description: "Stop intercepting console output. Previously captured logs remain in the buffer.",
+            inputSchema: {},
+        }, async () => {
+            this.interceptor.stopIntercepting();
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({ message: "Console interceptor stopped", active: false }),
+                    }],
+            };
+        });
+    }
+    registerCollectLogs() {
+        this.server.registerTool("collect_from_files", {
+            title: "Collect Logs from Files",
+            description: "Scan and collect logs from log files in the project directory. Automatically discovers .log and .json files in common log directories.",
+            inputSchema: {},
+        }, async () => {
+            await this.collector.collectFromFiles();
+            const stats = this.collector.getStats();
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({ message: "Log collection complete", stats }),
+                    }],
+            };
+        });
+    }
+    registerScanProject() {
+        this.server.registerTool("scan_project", {
+            title: "Scan Project Structure",
+            description: "Analyze the project to detect framework (React/Next.js/NestJS), find log files, and list configuration files.",
+            inputSchema: {},
+        }, async () => {
+            const structure = await this.collector.scanProjectStructure();
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify(structure, null, 2),
+                    }],
+            };
+        });
+    }
+    registerFindProcesses() {
+        this.server.registerTool("find_processes", {
+            title: "Find Running Node Processes",
+            description: "Find running Node.js processes related to React, Next.js, or NestJS applications.",
+            inputSchema: {},
+        }, async () => {
+            const processes = await this.inspector.findRunningProcesses();
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify(processes, null, 2),
+                    }],
+            };
+        });
+    }
+    registerGetPorts() {
+        this.server.registerTool("get_listening_ports", {
+            title: "Get Listening Ports",
+            description: "List all TCP ports currently being listened on by Node.js processes.",
+            inputSchema: {},
+        }, async () => {
+            const ports = await this.inspector.getPortListeners();
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify(ports, null, 2),
+                    }],
+            };
+        });
+    }
+    async start() {
+        try {
+            const transport = new StdioServerTransport();
+            await this.server.connect(transport);
+            console.error("Runtime Lens MCP Server started successfully");
+        }
+        catch (error) {
+            console.error("Failed to start Runtime Lens MCP Server:", error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    }
+    setupGracefulShutdown() {
+        const shutdown = async (signal) => {
+            console.error(`Received ${signal}, shutting down gracefully...`);
+            this.interceptor.stopIntercepting();
+            process.exit(0);
+        };
+        process.on("SIGINT", () => shutdown("SIGINT"));
+        process.on("SIGTERM", () => shutdown("SIGTERM"));
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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