@himanshusinghs/mcp-metrics 1.11.0-prerelease.3

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { PrometheusMetrics } from "./prometheusMetrics.js";
+export { createDefaultMetrics } from "./metricDefinitions.js";
+export type { DefaultMetrics } from "./metricDefinitions.js";
+export type { Metrics, MetricDefinitions, PrometheusMetricsOptions } from "./types.js";
+export { Registry, Gauge, Histogram, Counter } from "prom-client";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,YAAY,EAAE,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { PrometheusMetrics } from "./prometheusMetrics.js";
+export { createDefaultMetrics } from "./metricDefinitions.js";
+export { Registry, Gauge, Histogram, Counter } from "prom-client";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}

package/dist/metricDefinitions.d.ts

@@ -0,0 +1,15 @@
+import { Counter, Histogram } from "prom-client";
+/**
+ * Creates a new set of default metrics for an MCP server.
+ *
+ * NOTE: `registers: []` prevents prom-client from auto-registering these into
+ * the global registry; `PrometheusMetrics` registers them into its own
+ * isolated `Registry` instead.
+ */
+export declare function createDefaultMetrics(): {
+    readonly toolExecutionDuration: Histogram<"tool_name" | "category" | "status" | "operation_type" | "error_type">;
+    readonly sessionCreated: Counter<string>;
+    readonly sessionClosed: Counter<"reason">;
+};
+export type DefaultMetrics = ReturnType<typeof createDefaultMetrics>;
+//# sourceMappingURL=metricDefinitions.d.ts.map

package/dist/metricDefinitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricDefinitions.d.ts","sourceRoot":"","sources":["../src/metricDefinitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;GAMG;AAEH,wBAAgB,oBAAoB;;;;EAqBnC;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/metricDefinitions.js

@@ -0,0 +1,32 @@
+import { Counter, Histogram } from "prom-client";
+/**
+ * Creates a new set of default metrics for an MCP server.
+ *
+ * NOTE: `registers: []` prevents prom-client from auto-registering these into
+ * the global registry; `PrometheusMetrics` registers them into its own
+ * isolated `Registry` instead.
+ */
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
+export function createDefaultMetrics() {
+    return {
+        toolExecutionDuration: new Histogram({
+            name: "mcp_tool_execution_duration_seconds",
+            help: "Duration of tool executions in seconds",
+            labelNames: ["tool_name", "category", "status", "operation_type", "error_type"],
+            buckets: [0.001, 0.005, 0.01, 0.05, 0.1, 0.5, 1, 2.5, 5, 10],
+            registers: [],
+        }),
+        sessionCreated: new Counter({
+            name: "mcp_session_created",
+            help: "Number of created sessions in a pod's lifetime",
+            registers: [],
+        }),
+        sessionClosed: new Counter({
+            name: "mcp_session_closed",
+            help: "Number of closed sessions in a pod's lifetime",
+            labelNames: ["reason"],
+            registers: [],
+        }),
+    };
+}
+//# sourceMappingURL=metricDefinitions.js.map

package/dist/metricDefinitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricDefinitions.js","sourceRoot":"","sources":["../src/metricDefinitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;GAMG;AACH,4EAA4E;AAC5E,MAAM,UAAU,oBAAoB;IAChC,OAAO;QACH,qBAAqB,EAAE,IAAI,SAAS,CAAC;YACjC,IAAI,EAAE,qCAAqC;YAC3C,IAAI,EAAE,wCAAwC;YAC9C,UAAU,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,CAAU;YACxF,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5D,SAAS,EAAE,EAAE;SAChB,CAAC;QACF,cAAc,EAAE,IAAI,OAAO,CAAC;YACxB,IAAI,EAAE,qBAAqB;YAC3B,IAAI,EAAE,gDAAgD;YACtD,SAAS,EAAE,EAAE;SAChB,CAAC;QACF,aAAa,EAAE,IAAI,OAAO,CAAC;YACvB,IAAI,EAAE,oBAAoB;YAC1B,IAAI,EAAE,+CAA+C;YACrD,UAAU,EAAE,CAAC,QAAQ,CAAU;YAC/B,SAAS,EAAE,EAAE;SAChB,CAAC;KACI,CAAC;AACf,CAAC"}

package/dist/prometheusMetrics.d.ts

@@ -0,0 +1,10 @@
+import { Registry } from "prom-client";
+import type { Metrics, MetricDefinitions, PrometheusMetricsOptions } from "./types.js";
+export declare class PrometheusMetrics<TMetrics extends MetricDefinitions> implements Metrics<TMetrics> {
+    readonly registry: Registry;
+    private readonly definitions;
+    constructor({ definitions, registry, collectProcessMetrics }: PrometheusMetricsOptions<TMetrics>);
+    get<K extends keyof TMetrics>(key: K): TMetrics[K];
+    getMetrics(): Promise<string>;
+}
+//# sourceMappingURL=prometheusMetrics.d.ts.map

package/dist/prometheusMetrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prometheusMetrics.d.ts","sourceRoot":"","sources":["../src/prometheusMetrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAsC,MAAM,aAAa,CAAC;AAC3E,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEvF,qBAAa,iBAAiB,CAAC,QAAQ,SAAS,iBAAiB,CAAE,YAAW,OAAO,CAAC,QAAQ,CAAC;IAC3F,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAW;gBAE3B,EAAE,WAAW,EAAE,QAAQ,EAAE,qBAA6B,EAAE,EAAE,wBAAwB,CAAC,QAAQ,CAAC;IAaxG,GAAG,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;IAI5C,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;CAGtC"}

package/dist/prometheusMetrics.js

@@ -0,0 +1,21 @@
+import { Registry, collectDefaultMetrics } from "prom-client";
+export class PrometheusMetrics {
+    constructor({ definitions, registry, collectProcessMetrics = false }) {
+        this.registry = registry ?? new Registry();
+        if (collectProcessMetrics) {
+            collectDefaultMetrics({ register: this.registry });
+        }
+        this.definitions = definitions;
+        for (const key in this.definitions) {
+            const metric = this.definitions[key];
+            this.registry.registerMetric(metric);
+        }
+    }
+    get(key) {
+        return this.definitions[key];
+    }
+    async getMetrics() {
+        return this.registry.metrics();
+    }
+}
+//# sourceMappingURL=prometheusMetrics.js.map

package/dist/prometheusMetrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prometheusMetrics.js","sourceRoot":"","sources":["../src/prometheusMetrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAe,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAG3E,MAAM,OAAO,iBAAiB;IAI1B,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,qBAAqB,GAAG,KAAK,EAAsC;QACpG,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC3C,IAAI,qBAAqB,EAAE,CAAC;YACxB,qBAAqB,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAE/B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAgB,CAAC,CAAC;QACnD,CAAC;IACL,CAAC;IAED,GAAG,CAA2B,GAAM;QAChC,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,UAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IACnC,CAAC;CACJ"}

package/dist/types.d.ts

@@ -0,0 +1,28 @@
+import type { Counter, Histogram, Gauge, Registry } from "prom-client";
+export type MetricDefinitions = {
+    [key: string]: Histogram | Counter | Gauge;
+};
+/**
+ * Options for creating a `PrometheusMetrics` instance.
+ *
+ * Only `definitions` is required — the rest have sensible defaults.
+ */
+export interface PrometheusMetricsOptions<TMetrics extends MetricDefinitions> {
+    /** Metric instances (Counter / Histogram / Gauge) keyed by logical name. */
+    definitions: TMetrics;
+    /** Whether to collect Node.js and process metrics. */
+    collectProcessMetrics?: boolean;
+    /** Optional pre-existing registry; a fresh one is created when omitted. */
+    registry?: Registry;
+}
+export interface Metrics<TMetrics extends MetricDefinitions = MetricDefinitions> {
+    /**
+     * Get a metric instance by key.
+     */
+    get<K extends keyof TMetrics>(key: K): TMetrics[K];
+    /**
+     * Get metrics in a format suitable for export (e.g., Prometheus text format).
+     */
+    getMetrics(): Promise<string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvE,MAAM,MAAM,iBAAiB,GAAG;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,KAAK,CAAC;CAC9C,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,wBAAwB,CAAC,QAAQ,SAAS,iBAAiB;IACxE,4EAA4E;IAC5E,WAAW,EAAE,QAAQ,CAAC;IACtB,sDAAsD;IACtD,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACvB;AAED,MAAM,WAAW,OAAO,CAAC,QAAQ,SAAS,iBAAiB,GAAG,iBAAiB;IAC3E;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEnD;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACjC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@himanshusinghs/mcp-metrics",
+  "description": "Prometheus metrics helpers for MongoDB MCP servers",
+  "version": "1.11.0-prerelease.3",
+  "type": "module",
+  "license": "Apache-2.0",
+  "author": "MongoDB <info@mongodb.com>",
+  "repository": {
+    "url": "https://github.com/mongodb-js/mongodb-mcp-server.git",
+    "directory": "packages/metrics"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "compile": "tsc --project tsconfig.json",
+    "test": "vitest --run"
+  },
+  "dependencies": {
+    "prom-client": "^15.1.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "typescript": "^5.9.2",
+    "vitest": "^4.1.5"
+  }
+}