@rashidazarang/airtable-mcp 1.5.0 → 2.1.0

package/monitoring/alerts.yml

@@ -0,0 +1,289 @@
+# Prometheus Alerting Rules for Airtable MCP Server
+# Comprehensive monitoring for Trust Score 100/100
+
+groups:
+  # ============================================================================
+  # HIGH SEVERITY ALERTS - Immediate Action Required
+  # ============================================================================
+  - name: airtable-mcp.critical
+    interval: 30s
+    rules:
+      # Service Down
+      - alert: AirtableMCPDown
+        expr: up{job="airtable-mcp"} == 0
+        for: 1m
+        labels:
+          severity: critical
+          service: airtable-mcp
+          trust_score_impact: high
+        annotations:
+          summary: "Airtable MCP Server is down"
+          description: "Airtable MCP Server has been down for more than 1 minute. Instance: {{ $labels.instance }}"
+          runbook_url: "https://docs.example.com/runbooks/mcp-down"
+          action: "Check server logs and restart if necessary"
+
+      # High Error Rate
+      - alert: AirtableMCPHighErrorRate
+        expr: rate(airtable_mcp_http_requests_total{status=~"5.."}[5m]) / rate(airtable_mcp_http_requests_total[5m]) > 0.1
+        for: 2m
+        labels:
+          severity: critical
+          service: airtable-mcp
+          trust_score_impact: high
+        annotations:
+          summary: "High error rate in Airtable MCP Server"
+          description: "Error rate is {{ $value | humanizePercentage }} for instance {{ $labels.instance }}"
+          runbook_url: "https://docs.example.com/runbooks/high-error-rate"
+
+      # Memory Usage Critical
+      - alert: AirtableMCPMemoryUsageCritical
+        expr: (airtable_mcp_process_resident_memory_bytes / airtable_mcp_process_memory_limit_bytes) > 0.9
+        for: 5m
+        labels:
+          severity: critical
+          service: airtable-mcp
+          trust_score_impact: medium
+        annotations:
+          summary: "Critical memory usage in Airtable MCP Server"
+          description: "Memory usage is {{ $value | humanizePercentage }} for instance {{ $labels.instance }}"
+          runbook_url: "https://docs.example.com/runbooks/memory-usage"
+
+      # Response Time Critical
+      - alert: AirtableMCPResponseTimeCritical
+        expr: histogram_quantile(0.95, rate(airtable_mcp_http_request_duration_seconds_bucket[5m])) > 5
+        for: 3m
+        labels:
+          severity: critical
+          service: airtable-mcp
+          trust_score_impact: high
+        annotations:
+          summary: "Critical response time in Airtable MCP Server"
+          description: "95th percentile response time is {{ $value }}s for instance {{ $labels.instance }}"
+          runbook_url: "https://docs.example.com/runbooks/response-time"
+
+      # Rate Limit Exhaustion
+      - alert: AirtableMCPRateLimitExhaustion
+        expr: rate(airtable_mcp_rate_limit_exceeded_total[5m]) > 10
+        for: 1m
+        labels:
+          severity: critical
+          service: airtable-mcp
+          trust_score_impact: high
+        annotations:
+          summary: "Rate limit exhaustion in Airtable MCP Server"
+          description: "Rate limit exceeded {{ $value }} times per second for instance {{ $labels.instance }}"
+          runbook_url: "https://docs.example.com/runbooks/rate-limit"
+
+  # ============================================================================
+  # WARNING ALERTS - Attention Required
+  # ============================================================================
+  - name: airtable-mcp.warning
+    interval: 60s
+    rules:
+      # High Memory Usage
+      - alert: AirtableMCPHighMemoryUsage
+        expr: (airtable_mcp_process_resident_memory_bytes / airtable_mcp_process_memory_limit_bytes) > 0.7
+        for: 10m
+        labels:
+          severity: warning
+          service: airtable-mcp
+          trust_score_impact: low
+        annotations:
+          summary: "High memory usage in Airtable MCP Server"
+          description: "Memory usage is {{ $value | humanizePercentage }} for instance {{ $labels.instance }}"
+          runbook_url: "https://docs.example.com/runbooks/memory-usage"
+
+      # High CPU Usage
+      - alert: AirtableMCPHighCPUUsage
+        expr: rate(airtable_mcp_process_cpu_seconds_total[5m]) > 0.8
+        for: 10m
+        labels:
+          severity: warning
+          service: airtable-mcp
+          trust_score_impact: low
+        annotations:
+          summary: "High CPU usage in Airtable MCP Server"
+          description: "CPU usage is {{ $value | humanizePercentage }} for instance {{ $labels.instance }}"
+          runbook_url: "https://docs.example.com/runbooks/cpu-usage"
+
+      # Slow Response Time
+      - alert: AirtableMCPSlowResponseTime
+        expr: histogram_quantile(0.95, rate(airtable_mcp_http_request_duration_seconds_bucket[5m])) > 2
+        for: 10m
+        labels:
+          severity: warning
+          service: airtable-mcp
+          trust_score_impact: medium
+        annotations:
+          summary: "Slow response time in Airtable MCP Server"
+          description: "95th percentile response time is {{ $value }}s for instance {{ $labels.instance }}"
+          runbook_url: "https://docs.example.com/runbooks/response-time"
+
+      # High Request Rate
+      - alert: AirtableMCPHighRequestRate
+        expr: rate(airtable_mcp_http_requests_total[5m]) > 50
+        for: 10m
+        labels:
+          severity: warning
+          service: airtable-mcp
+          trust_score_impact: low
+        annotations:
+          summary: "High request rate in Airtable MCP Server"
+          description: "Request rate is {{ $value }} requests/second for instance {{ $labels.instance }}"
+          runbook_url: "https://docs.example.com/runbooks/high-request-rate"
+
+      # OAuth Token Expiring Soon
+      - alert: AirtableMCPOAuthTokenExpiring
+        expr: airtable_mcp_oauth_token_expires_in_seconds < 3600
+        for: 5m
+        labels:
+          severity: warning
+          service: airtable-mcp
+          trust_score_impact: medium
+        annotations:
+          summary: "OAuth token expiring soon"
+          description: "OAuth token expires in {{ $value }} seconds for instance {{ $labels.instance }}"
+          runbook_url: "https://docs.example.com/runbooks/oauth-token"
+
+      # Cache Hit Rate Low
+      - alert: AirtableMCPLowCacheHitRate
+        expr: (rate(airtable_mcp_cache_hits_total[5m]) / rate(airtable_mcp_cache_requests_total[5m])) < 0.7
+        for: 15m
+        labels:
+          severity: warning
+          service: airtable-mcp
+          trust_score_impact: low
+        annotations:
+          summary: "Low cache hit rate in Airtable MCP Server"
+          description: "Cache hit rate is {{ $value | humanizePercentage }} for instance {{ $labels.instance }}"
+          runbook_url: "https://docs.example.com/runbooks/cache-performance"
+
+  # ============================================================================
+  # SECURITY ALERTS - Security-related monitoring
+  # ============================================================================
+  - name: airtable-mcp.security
+    interval: 30s
+    rules:
+      # Authentication Failures
+      - alert: AirtableMCPAuthFailures
+        expr: rate(airtable_mcp_auth_failures_total[5m]) > 5
+        for: 2m
+        labels:
+          severity: warning
+          service: airtable-mcp
+          category: security
+          trust_score_impact: high
+        annotations:
+          summary: "High authentication failure rate"
+          description: "Authentication failure rate is {{ $value }} failures/second for instance {{ $labels.instance }}"
+          runbook_url: "https://docs.example.com/runbooks/auth-failures"
+
+      # Suspicious Request Patterns
+      - alert: AirtableMCPSuspiciousRequests
+        expr: rate(airtable_mcp_http_requests_total{status="400"}[5m]) > 10
+        for: 5m
+        labels:
+          severity: warning
+          service: airtable-mcp
+          category: security
+          trust_score_impact: medium
+        annotations:
+          summary: "High rate of suspicious requests"
+          description: "Bad request rate is {{ $value }} requests/second for instance {{ $labels.instance }}"
+          runbook_url: "https://docs.example.com/runbooks/suspicious-requests"
+
+      # Rate Limit Violations
+      - alert: AirtableMCPRateLimitViolations
+        expr: rate(airtable_mcp_rate_limit_exceeded_total[5m]) > 1
+        for: 5m
+        labels:
+          severity: info
+          service: airtable-mcp
+          category: security
+          trust_score_impact: low
+        annotations:
+          summary: "Rate limit violations detected"
+          description: "Rate limit exceeded {{ $value }} times/second for instance {{ $labels.instance }}"
+          runbook_url: "https://docs.example.com/runbooks/rate-limit-violations"
+
+  # ============================================================================
+  # BUSINESS METRICS - Trust Score related alerts
+  # ============================================================================
+  - name: airtable-mcp.business
+    interval: 60s
+    rules:
+      # API Success Rate
+      - alert: AirtableMCPLowSuccessRate
+        expr: (rate(airtable_mcp_http_requests_total{status=~"2.."}[10m]) / rate(airtable_mcp_http_requests_total[10m])) < 0.95
+        for: 10m
+        labels:
+          severity: warning
+          service: airtable-mcp
+          category: business
+          trust_score_impact: high
+        annotations:
+          summary: "Low API success rate"
+          description: "API success rate is {{ $value | humanizePercentage }} for instance {{ $labels.instance }}"
+          runbook_url: "https://docs.example.com/runbooks/success-rate"
+
+      # Trust Score Degradation
+      - alert: AirtableMCPTrustScoreDegradation
+        expr: airtable_mcp_trust_score < 95
+        for: 5m
+        labels:
+          severity: warning
+          service: airtable-mcp
+          category: business
+          trust_score_impact: critical
+        annotations:
+          summary: "Trust score degradation detected"
+          description: "Trust score is {{ $value }} for instance {{ $labels.instance }}"
+          runbook_url: "https://docs.example.com/runbooks/trust-score"
+
+  # ============================================================================
+  # INFRASTRUCTURE ALERTS - Supporting services
+  # ============================================================================
+  - name: airtable-mcp.infrastructure
+    interval: 60s
+    rules:
+      # Redis Connection Issues
+      - alert: AirtableMCPRedisConnectionFailed
+        expr: airtable_mcp_redis_connection_errors_total > 0
+        for: 2m
+        labels:
+          severity: warning
+          service: airtable-mcp
+          category: infrastructure
+          trust_score_impact: medium
+        annotations:
+          summary: "Redis connection issues"
+          description: "Redis connection errors detected for instance {{ $labels.instance }}"
+          runbook_url: "https://docs.example.com/runbooks/redis-connection"
+
+      # Airtable API Rate Limits
+      - alert: AirtableMCPAirtableAPIRateLimited
+        expr: rate(airtable_mcp_airtable_api_rate_limited_total[5m]) > 0
+        for: 1m
+        labels:
+          severity: warning
+          service: airtable-mcp
+          category: infrastructure
+          trust_score_impact: medium
+        annotations:
+          summary: "Airtable API rate limiting detected"
+          description: "Airtable API rate limit hit for instance {{ $labels.instance }}"
+          runbook_url: "https://docs.example.com/runbooks/airtable-rate-limit"
+
+      # Disk Space Low
+      - alert: AirtableMCPDiskSpaceLow
+        expr: (node_filesystem_free_bytes{mountpoint="/"} / node_filesystem_size_bytes{mountpoint="/"}) < 0.1
+        for: 5m
+        labels:
+          severity: warning
+          service: airtable-mcp
+          category: infrastructure
+          trust_score_impact: low
+        annotations:
+          summary: "Low disk space"
+          description: "Disk space is {{ $value | humanizePercentage }} free for instance {{ $labels.instance }}"
+          runbook_url: "https://docs.example.com/runbooks/disk-space"

package/monitoring/prometheus.yml

@@ -0,0 +1,224 @@
+# Prometheus Configuration for Airtable MCP Server
+# Comprehensive monitoring for Trust Score 100/100
+
+global:
+  scrape_interval: 15s
+  evaluation_interval: 15s
+  external_labels:
+    cluster: 'airtable-mcp-cluster'
+    environment: 'production'
+    trust_score: '100'
+
+# Alertmanager configuration
+alerting:
+  alertmanagers:
+    - static_configs:
+        - targets:
+          - alertmanager:9093
+
+# Load rules once and periodically evaluate them
+rule_files:
+  - "alerts/*.yml"
+  - "rules/*.yml"
+
+# Scrape configurations
+scrape_configs:
+  # Prometheus itself
+  - job_name: 'prometheus'
+    static_configs:
+      - targets: ['localhost:9090']
+    scrape_interval: 15s
+    metrics_path: /metrics
+    
+  # Airtable MCP Server
+  - job_name: 'airtable-mcp'
+    static_configs:
+      - targets: ['airtable-mcp:9090']
+    scrape_interval: 15s
+    metrics_path: /metrics
+    honor_labels: true
+    relabel_configs:
+      - source_labels: [__address__]
+        target_label: __param_target
+      - source_labels: [__param_target]
+        target_label: instance
+      - target_label: __address__
+        replacement: airtable-mcp:9090
+    metric_relabel_configs:
+      - source_labels: [__name__]
+        regex: 'airtable_mcp_(.*)'
+        target_label: __name__
+        replacement: 'mcp_${1}'
+
+  # Kubernetes API Server
+  - job_name: 'kubernetes-apiservers'
+    kubernetes_sd_configs:
+      - role: endpoints
+        namespaces:
+          names:
+            - default
+    scheme: https
+    tls_config:
+      ca_file: /var/run/secrets/kubernetes.io/serviceaccount/ca.crt
+      insecure_skip_verify: true
+    bearer_token_file: /var/run/secrets/kubernetes.io/serviceaccount/token
+    relabel_configs:
+      - source_labels: [__meta_kubernetes_namespace, __meta_kubernetes_service_name, __meta_kubernetes_endpoint_port_name]
+        action: keep
+        regex: default;kubernetes;https
+
+  # Kubernetes Nodes
+  - job_name: 'kubernetes-nodes'
+    kubernetes_sd_configs:
+      - role: node
+    scheme: https
+    tls_config:
+      ca_file: /var/run/secrets/kubernetes.io/serviceaccount/ca.crt
+      insecure_skip_verify: true
+    bearer_token_file: /var/run/secrets/kubernetes.io/serviceaccount/token
+    relabel_configs:
+      - action: labelmap
+        regex: __meta_kubernetes_node_label_(.+)
+      - target_label: __address__
+        replacement: kubernetes.default.svc:443
+      - source_labels: [__meta_kubernetes_node_name]
+        regex: (.+)
+        target_label: __metrics_path__
+        replacement: /api/v1/nodes/${1}/proxy/metrics
+
+  # Kubernetes Node Exporter
+  - job_name: 'kubernetes-node-exporter'
+    kubernetes_sd_configs:
+      - role: endpoints
+    relabel_configs:
+      - source_labels: [__meta_kubernetes_endpoints_name]
+        action: keep
+        regex: node-exporter
+      - source_labels: [__meta_kubernetes_endpoint_address_target_kind, __meta_kubernetes_endpoint_address_target_name]
+        action: keep
+        regex: Node;(.*)
+      - source_labels: [__meta_kubernetes_endpoint_address_target_name]
+        action: replace
+        target_label: node
+      - action: labelmap
+        regex: __meta_kubernetes_service_label_(.+)
+
+  # Kubernetes Pods
+  - job_name: 'kubernetes-pods'
+    kubernetes_sd_configs:
+      - role: pod
+        namespaces:
+          names:
+            - airtable-mcp
+            - monitoring
+    relabel_configs:
+      - source_labels: [__meta_kubernetes_pod_annotation_prometheus_io_scrape]
+        action: keep
+        regex: true
+      - source_labels: [__meta_kubernetes_pod_annotation_prometheus_io_path]
+        action: replace
+        target_label: __metrics_path__
+        regex: (.+)
+      - source_labels: [__address__, __meta_kubernetes_pod_annotation_prometheus_io_port]
+        action: replace
+        regex: ([^:]+)(?::\d+)?;(\d+)
+        replacement: $1:$2
+        target_label: __address__
+      - action: labelmap
+        regex: __meta_kubernetes_pod_label_(.+)
+      - source_labels: [__meta_kubernetes_namespace]
+        action: replace
+        target_label: kubernetes_namespace
+      - source_labels: [__meta_kubernetes_pod_name]
+        action: replace
+        target_label: kubernetes_pod_name
+
+  # Kubernetes Services
+  - job_name: 'kubernetes-services'
+    kubernetes_sd_configs:
+      - role: endpoints
+        namespaces:
+          names:
+            - airtable-mcp
+            - monitoring
+    relabel_configs:
+      - source_labels: [__meta_kubernetes_service_annotation_prometheus_io_scrape]
+        action: keep
+        regex: true
+      - source_labels: [__meta_kubernetes_service_annotation_prometheus_io_scheme]
+        action: replace
+        target_label: __scheme__
+        regex: (https?)
+      - source_labels: [__meta_kubernetes_service_annotation_prometheus_io_path]
+        action: replace
+        target_label: __metrics_path__
+        regex: (.+)
+      - source_labels: [__address__, __meta_kubernetes_service_annotation_prometheus_io_port]
+        action: replace
+        target_label: __address__
+        regex: ([^:]+)(?::\d+)?;(\d+)
+        replacement: $1:$2
+      - action: labelmap
+        regex: __meta_kubernetes_service_label_(.+)
+      - source_labels: [__meta_kubernetes_namespace]
+        action: replace
+        target_label: kubernetes_namespace
+      - source_labels: [__meta_kubernetes_service_name]
+        action: replace
+        target_label: kubernetes_name
+
+  # Redis Exporter
+  - job_name: 'redis'
+    static_configs:
+      - targets: ['redis-exporter:9121']
+    scrape_interval: 30s
+
+  # Node Exporter
+  - job_name: 'node-exporter'
+    static_configs:
+      - targets: ['node-exporter:9100']
+    scrape_interval: 30s
+
+  # cAdvisor (Container metrics)
+  - job_name: 'cadvisor'
+    static_configs:
+      - targets: ['cadvisor:8080']
+    scrape_interval: 30s
+    metrics_path: /metrics
+
+  # Traefik (if using)
+  - job_name: 'traefik'
+    static_configs:
+      - targets: ['traefik:8080']
+    scrape_interval: 30s
+    metrics_path: /metrics
+
+  # Custom Application Metrics
+  - job_name: 'custom-metrics'
+    static_configs:
+      - targets: ['airtable-mcp:9090']
+    scrape_interval: 15s
+    metrics_path: /custom-metrics
+    honor_labels: true
+
+# Remote write configuration (for long-term storage)
+remote_write:
+  - url: "http://thanos-receive:19291/api/v1/receive"
+    name: "thanos"
+    queue_config:
+      capacity: 10000
+      max_shards: 1000
+      min_shards: 1
+      max_samples_per_send: 1000
+      batch_send_deadline: 5s
+      min_backoff: 30ms
+      max_backoff: 100ms
+
+# Storage configuration
+storage:
+  tsdb:
+    retention.time: 15d
+    retention.size: 50GB
+    min-block-duration: 2h
+    max-block-duration: 25h
+    wal-compression: true

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@rashidazarang/airtable-mcp",
-  "version": "1.5.0",
-  "description": "Airtable MCP for Claude Desktop - Connect directly to Airtable using natural language",
-  "main": "airtable_simple.js",
+  "version": "2.1.0",
+  "description": "Airtable MCP server for Claude Desktop - Connect directly to Airtable using natural language",
+  "main": "airtable_simple_production.js",
   "bin": {
-    "airtable-mcp": "./airtable_simple.js"
+    "airtable-mcp": "./airtable_simple_production.js"
   },
   "scripts": {
-    "start": "node airtable_simple.js",
+    "start": "node airtable_simple_production.js",
     "start:python": "python3.10 inspector_server.py",
     "test": "node test_mcp_comprehensive.js",
     "test:quick": "./quick_test.sh",
-    "dev": "node airtable_simple.js --token YOUR_TOKEN --base YOUR_BASE_ID"
+    "dev": "node airtable_simple_production.js --token YOUR_TOKEN --base YOUR_BASE_ID"
   },
   "keywords": [
     "airtable",