observability-toolkit 1.0.0

package/dist/tools/query-traces.js

@@ -0,0 +1,83 @@
+/**
+ * Query traces from local JSONL or SigNoz
+ */
+import { z } from 'zod';
+import { LocalJsonlBackend } from '../backends/local-jsonl.js';
+import { SigNozApiBackend } from '../backends/signoz-api.js';
+import { SIGNOZ_URL, SIGNOZ_API_KEY } from '../lib/constants.js';
+export const queryTracesSchema = z.object({
+    backend: z.enum(['local', 'signoz', 'auto']).default('auto').describe('Backend to query: local (JSONL files), signoz (API), or auto (tries both)'),
+    traceId: z.string().optional().describe('Filter by specific trace ID'),
+    serviceName: z.string().optional().describe('Filter by service name'),
+    spanName: z.string().optional().describe('Filter by span name (substring match)'),
+    minDurationMs: z.number().optional().describe('Minimum span duration in milliseconds'),
+    maxDurationMs: z.number().optional().describe('Maximum span duration in milliseconds'),
+    startDate: z.string().optional().describe('Start date (YYYY-MM-DD)'),
+    endDate: z.string().optional().describe('End date (YYYY-MM-DD)'),
+    limit: z.number().default(50).describe('Maximum number of results'),
+});
+export async function queryTraces(input) {
+    const options = {
+        traceId: input.traceId,
+        serviceName: input.serviceName,
+        spanName: input.spanName,
+        minDurationMs: input.minDurationMs,
+        maxDurationMs: input.maxDurationMs,
+        startDate: input.startDate,
+        endDate: input.endDate,
+        limit: input.limit,
+    };
+    const hasSigNozConfig = SIGNOZ_URL && SIGNOZ_API_KEY;
+    const backend = input.backend === 'auto'
+        ? (hasSigNozConfig ? 'signoz' : 'local')
+        : input.backend;
+    if (backend === 'local' || input.backend === 'auto') {
+        const local = new LocalJsonlBackend();
+        const traces = await local.queryTraces(options);
+        if (traces.length > 0 || backend === 'local') {
+            return {
+                backend: 'local',
+                count: traces.length,
+                traces: traces.map(t => ({
+                    traceId: t.traceId,
+                    spanId: t.spanId,
+                    name: t.name,
+                    kind: t.kind,
+                    durationMs: t.durationMs,
+                    status: t.status,
+                    attributes: t.attributes,
+                })),
+            };
+        }
+    }
+    if (backend === 'signoz' || (input.backend === 'auto' && hasSigNozConfig)) {
+        const signoz = new SigNozApiBackend();
+        const traces = await signoz.queryTraces(options);
+        return {
+            backend: 'signoz',
+            count: traces.length,
+            traces: traces.map(t => ({
+                traceId: t.traceId,
+                spanId: t.spanId,
+                name: t.name,
+                kind: t.kind,
+                durationMs: t.durationMs,
+                status: t.status,
+                attributes: t.attributes,
+            })),
+        };
+    }
+    return {
+        backend: 'none',
+        count: 0,
+        traces: [],
+        error: 'No backend available',
+    };
+}
+export const queryTracesTool = {
+    name: 'obs_query_traces',
+    description: 'Query traces from local JSONL files or SigNoz Cloud. Filter by trace ID, service name, span name, duration, and date range.',
+    inputSchema: queryTracesSchema,
+    handler: queryTraces,
+};
+//# sourceMappingURL=query-traces.js.map

package/dist/tools/query-traces.js.map

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

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "observability-toolkit",
+  "version": "1.0.0",
+  "description": "MCP server for observability tooling - query traces, metrics, logs from local JSONL or SigNoz",
+  "type": "module",
+  "main": "dist/server.js",
+  "bin": {
+    "observability-toolkit": "dist/server.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "start": "node dist/server.js",
+    "test": "node --test dist/**/*.test.js"
+  },
+  "keywords": [
+    "mcp",
+    "observability",
+    "opentelemetry",
+    "traces",
+    "metrics",
+    "logs",
+    "signoz",
+    "claude-code"
+  ],
+  "author": "Alyshia Ledlie",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.11.2",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.21",
+    "typescript": "^5.8.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}