Add Prometheus metrics and Segment analytics integration

- Updated `aap-mcp.sample.yaml` to include configuration options for Prometheus metrics and Segment analytics.
- Added new `MetricsService` class for collecting and exposing metrics.
- Implemented `AnalyticsService` for tracking tool usage and service events with anonymized data.
- Enhanced `ToolLogger` to record metrics and analytics during tool execution.
- Introduced `/metrics` endpoint for Prometheus scraping.
- Updated `index.ts` to initialize analytics and metrics services based on configuration.

Author: cshiels-ie

aap-mcp.sample.yaml

@@ -8,6 +8,13 @@
 # Configuration for Web UI (defaults to false if not specified)
 # enable_ui: false
 
+# Configuration for Prometheus metrics endpoint (defaults to true if not specified)
+# enable_metrics: true
+
+# Configuration for Segment.com analytics (defaults to true if segment_write_key is provided)
+# enable_analytics: true
+# segment_write_key: "your_segment_write_key_here"
+
 # Configuration for base URL (defaults to https://localhost if not specified)
 # Lower priority than BASE_URL environment variable
 # base_url: "https://localhost:8443"

package-lock.json

@@ -23,6 +23,7 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.18.1",
+    "@segment/analytics-node": "^2.1.2",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^24.5.2",
     "cors": "^2.8.5",
@@ -31,6 +32,8 @@
     "oas-normalize": "^15.0.2",
     "openapi-mcp-generator": "^3.2.0",
     "openapi-types": "^12.1.3",
+    "prom-client": "^15.1.3",
+    "tsc": "^2.0.4",
     "typescript": "^5.9.2"
   },
   "devDependencies": {