qorrelate-mcp-server 0.1.0

package/dist/tools/logs.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Log-related MCP tools
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { QorrelateClient } from "../client.js";
+export declare function registerLogTools(): Tool[];
+export declare function handleLogTool(client: QorrelateClient, toolName: string, args: Record<string, unknown> | undefined): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=logs.d.ts.map

package/dist/tools/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../src/tools/logs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wBAAgB,gBAAgB,IAAI,IAAI,EAAE,CAuFzC;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACxC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAyGhF"}

package/dist/tools/logs.js

@@ -0,0 +1,191 @@
+"use strict";
+/**
+ * Log-related MCP tools
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerLogTools = registerLogTools;
+exports.handleLogTool = handleLogTool;
+function registerLogTools() {
+    return [
+        {
+            name: "query_logs",
+            description: `Search application logs with filters. Use this to investigate errors, debug issues, or understand application behavior.
+
+Examples:
+- Find all errors: query_logs with severity="ERROR"
+- Find logs for a service: query_logs with service="checkout"
+- Search by content: query_logs with query="payment failed"
+- Find logs in a time range: query_logs with start_time and end_time`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    query: {
+                        type: "string",
+                        description: "Search query - matches log body content. Supports field:value syntax like 'user_id:123'",
+                    },
+                    severity: {
+                        type: "string",
+                        enum: ["DEBUG", "INFO", "WARN", "ERROR", "FATAL"],
+                        description: "Filter by log severity level",
+                    },
+                    service: {
+                        type: "string",
+                        description: "Filter by service name",
+                    },
+                    start_time: {
+                        type: "string",
+                        description: "Start of time range (ISO 8601 format). Defaults to 1 hour ago.",
+                    },
+                    end_time: {
+                        type: "string",
+                        description: "End of time range (ISO 8601 format). Defaults to now.",
+                    },
+                    limit: {
+                        type: "number",
+                        description: "Maximum number of logs to return (default: 50, max: 500)",
+                        default: 50,
+                    },
+                },
+            },
+        },
+        {
+            name: "logs_get_histogram",
+            description: "Get a histogram of log counts over time. Useful for visualizing log volume trends and identifying spikes.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    start_time: {
+                        type: "string",
+                        description: "Start of time range (ISO 8601 format)",
+                    },
+                    end_time: {
+                        type: "string",
+                        description: "End of time range (ISO 8601 format)",
+                    },
+                    query: {
+                        type: "string",
+                        description: "Optional query to filter logs for the histogram",
+                    },
+                },
+            },
+        },
+        {
+            name: "logs_get_error_summary",
+            description: "Get a summary of errors for a service. Groups errors by message and shows counts.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    service: {
+                        type: "string",
+                        description: "Service name to analyze",
+                    },
+                    start_time: {
+                        type: "string",
+                        description: "Start of time range (ISO 8601 format). Defaults to 1 hour ago.",
+                    },
+                    end_time: {
+                        type: "string",
+                        description: "End of time range (ISO 8601 format). Defaults to now.",
+                    },
+                },
+                required: ["service"],
+            },
+        },
+    ];
+}
+async function handleLogTool(client, toolName, args) {
+    const params = args || {};
+    switch (toolName) {
+        case "query_logs": {
+            const result = await client.searchLogs({
+                query: params.query,
+                severity: params.severity,
+                service: params.service,
+                start_time: params.start_time,
+                end_time: params.end_time,
+                limit: Math.min(params.limit || 50, 500),
+            });
+            // Format logs for readability
+            const formattedLogs = result.logs.map(log => ({
+                timestamp: log.timestamp,
+                severity: log.severity,
+                service: log.service_name || 'unknown',
+                message: log.body,
+                trace_id: log.trace_id,
+            }));
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            total: result.total,
+                            returned: formattedLogs.length,
+                            has_more: result.has_more,
+                            logs: formattedLogs,
+                        }, null, 2),
+                    }],
+            };
+        }
+        case "logs_get_histogram": {
+            const result = await client.getLogHistogram({
+                start_time: params.start_time,
+                end_time: params.end_time,
+                query: params.query,
+            });
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    }],
+            };
+        }
+        case "logs_get_error_summary": {
+            // Get error logs for the service
+            const result = await client.searchLogs({
+                service: params.service,
+                severity: "ERROR",
+                start_time: params.start_time,
+                end_time: params.end_time,
+                limit: 500,
+            });
+            // Group by error message
+            const errorCounts = new Map();
+            const errorExamples = new Map();
+            for (const log of result.logs) {
+                // Normalize error message (first 200 chars)
+                const key = log.body.substring(0, 200);
+                errorCounts.set(key, (errorCounts.get(key) || 0) + 1);
+                if (!errorExamples.has(key)) {
+                    errorExamples.set(key, {
+                        timestamp: log.timestamp,
+                        trace_id: log.trace_id,
+                    });
+                }
+            }
+            // Sort by count descending
+            const summary = Array.from(errorCounts.entries())
+                .map(([message, count]) => ({
+                message,
+                count,
+                example: errorExamples.get(message),
+            }))
+                .sort((a, b) => b.count - a.count);
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            service: params.service,
+                            total_errors: result.logs.length,
+                            unique_error_types: summary.length,
+                            errors: summary,
+                        }, null, 2),
+                    }],
+            };
+        }
+        default:
+            return {
+                content: [{ type: "text", text: `Unknown log tool: ${toolName}` }],
+                isError: true,
+            };
+    }
+}
+//# sourceMappingURL=logs.js.map

package/dist/tools/logs.js.map

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

package/dist/tools/metrics.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Metrics-related MCP tools
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { QorrelateClient } from "../client.js";
+export declare function registerMetricTools(): Tool[];
+export declare function handleMetricTool(client: QorrelateClient, toolName: string, args: Record<string, unknown> | undefined): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/tools/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/tools/metrics.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wBAAgB,mBAAmB,IAAI,IAAI,EAAE,CA8F5C;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACxC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA4HhF"}

package/dist/tools/metrics.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * Metrics-related MCP tools
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerMetricTools = registerMetricTools;
+exports.handleMetricTool = handleMetricTool;
+function registerMetricTools() {
+    return [
+        {
+            name: "query_metrics",
+            description: `Query time-series metrics data. Use this to analyze system performance, resource usage, and business metrics.
+
+Examples:
+- CPU usage: query_metrics with metric_name="system.cpu.usage"
+- Request rate: query_metrics with metric_name="http.server.request.count"
+- Error rate by service: query_metrics with metric_name="http.server.errors" and group_by="service.name"`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    metric_name: {
+                        type: "string",
+                        description: "Name of the metric to query (e.g., http.server.duration, system.memory.usage)",
+                    },
+                    aggregation: {
+                        type: "string",
+                        enum: ["avg", "sum", "min", "max", "count"],
+                        description: "How to aggregate the metric values (default: avg)",
+                        default: "avg",
+                    },
+                    group_by: {
+                        type: "string",
+                        description: "Label to group results by (e.g., service.name, http.method)",
+                    },
+                    start_time: {
+                        type: "string",
+                        description: "Start of time range (ISO 8601 format). Defaults to 1 hour ago.",
+                    },
+                    end_time: {
+                        type: "string",
+                        description: "End of time range (ISO 8601 format). Defaults to now.",
+                    },
+                },
+                required: ["metric_name"],
+            },
+        },
+        {
+            name: "metrics_list",
+            description: "List available metrics. Use this to discover what metrics are being collected.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    prefix: {
+                        type: "string",
+                        description: "Filter metrics by name prefix (e.g., 'http' for all HTTP metrics)",
+                    },
+                    limit: {
+                        type: "number",
+                        description: "Maximum number of metrics to return (default: 50)",
+                        default: 50,
+                    },
+                },
+            },
+        },
+        {
+            name: "metrics_compare",
+            description: "Compare a metric between two time periods. Useful for before/after analysis of deployments or changes.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    metric_name: {
+                        type: "string",
+                        description: "Name of the metric to compare",
+                    },
+                    period1_start: {
+                        type: "string",
+                        description: "Start of first period (ISO 8601 format)",
+                    },
+                    period1_end: {
+                        type: "string",
+                        description: "End of first period (ISO 8601 format)",
+                    },
+                    period2_start: {
+                        type: "string",
+                        description: "Start of second period (ISO 8601 format)",
+                    },
+                    period2_end: {
+                        type: "string",
+                        description: "End of second period (ISO 8601 format)",
+                    },
+                    aggregation: {
+                        type: "string",
+                        enum: ["avg", "sum", "min", "max"],
+                        description: "How to aggregate values for comparison",
+                        default: "avg",
+                    },
+                },
+                required: ["metric_name", "period1_start", "period1_end", "period2_start", "period2_end"],
+            },
+        },
+    ];
+}
+async function handleMetricTool(client, toolName, args) {
+    const params = args || {};
+    switch (toolName) {
+        case "query_metrics": {
+            const metricName = params.metric_name;
+            if (!metricName) {
+                return {
+                    content: [{ type: "text", text: "metric_name is required" }],
+                    isError: true,
+                };
+            }
+            const result = await client.queryMetrics({
+                metric_name: metricName,
+                aggregation: params.aggregation || 'avg',
+                group_by: params.group_by,
+                start_time: params.start_time,
+                end_time: params.end_time,
+            });
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    }],
+            };
+        }
+        case "metrics_list": {
+            const result = await client.listMetrics({
+                prefix: params.prefix,
+                limit: params.limit || 50,
+            });
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            count: result.metrics.length,
+                            metrics: result.metrics,
+                        }, null, 2),
+                    }],
+            };
+        }
+        case "metrics_compare": {
+            const metricName = params.metric_name;
+            if (!metricName) {
+                return {
+                    content: [{ type: "text", text: "metric_name is required" }],
+                    isError: true,
+                };
+            }
+            const aggregation = params.aggregation || 'avg';
+            // Fetch both periods
+            const [period1, period2] = await Promise.all([
+                client.queryMetrics({
+                    metric_name: metricName,
+                    aggregation,
+                    start_time: params.period1_start,
+                    end_time: params.period1_end,
+                }),
+                client.queryMetrics({
+                    metric_name: metricName,
+                    aggregation,
+                    start_time: params.period2_start,
+                    end_time: params.period2_end,
+                }),
+            ]);
+            // Calculate aggregate values for each period
+            const calculateAggregate = (dataPoints) => {
+                if (dataPoints.length === 0)
+                    return 0;
+                const values = dataPoints.map(d => d.value);
+                switch (aggregation) {
+                    case 'sum': return values.reduce((a, b) => a + b, 0);
+                    case 'min': return Math.min(...values);
+                    case 'max': return Math.max(...values);
+                    case 'avg':
+                    default: return values.reduce((a, b) => a + b, 0) / values.length;
+                }
+            };
+            const value1 = calculateAggregate(period1.data_points);
+            const value2 = calculateAggregate(period2.data_points);
+            const change = value1 !== 0 ? ((value2 - value1) / value1) * 100 : 0;
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            metric_name: metricName,
+                            aggregation,
+                            period1: {
+                                start: params.period1_start,
+                                end: params.period1_end,
+                                value: Math.round(value1 * 1000) / 1000,
+                                data_points: period1.data_points.length,
+                            },
+                            period2: {
+                                start: params.period2_start,
+                                end: params.period2_end,
+                                value: Math.round(value2 * 1000) / 1000,
+                                data_points: period2.data_points.length,
+                            },
+                            change: {
+                                absolute: Math.round((value2 - value1) * 1000) / 1000,
+                                percent: Math.round(change * 100) / 100,
+                                direction: change > 0 ? "increased" : change < 0 ? "decreased" : "unchanged",
+                            },
+                        }, null, 2),
+                    }],
+            };
+        }
+        default:
+            return {
+                content: [{ type: "text", text: `Unknown metrics tool: ${toolName}` }],
+                isError: true,
+            };
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/tools/metrics.js.map

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

package/dist/tools/organizations.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Organization Management Tools
+ *
+ * Tools for managing organizations, members, invitations, and API keys.
+ * Enables AI agents to fully automate the setup and onboarding process.
+ */
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { QorrelateClient } from "../client.js";
+export declare function registerOrganizationTools(): Tool[];
+export declare function handleOrganizationTool(client: QorrelateClient, name: string, args: Record<string, unknown>): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=organizations.d.ts.map

package/dist/tools/organizations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"organizations.d.ts","sourceRoot":"","sources":["../../src/tools/organizations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,wBAAgB,yBAAyB,IAAI,IAAI,EAAE,CA0NlD;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA8J7D"}