@rashidazarang/airtable-mcp 1.6.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.6.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",

package/.claude/settings.local.json

@@ -1,12 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(cat:*)",
-      "WebFetch(domain:github.com)",
-      "Bash(# Test create with simpler extraction\necho \"\"TEST: CREATE AND EXTRACT ID\"\"\ncurl -s -X POST http://localhost:8010/mcp \\\n  -H \"\"Content-Type: application/json\"\" \\\n  -d ''{\"\"jsonrpc\"\": \"\"2.0\"\", \"\"id\"\": 2, \"\"method\"\": \"\"tools/call\"\", \"\"params\"\": {\"\"name\"\": \"\"create_record\"\", \"\"arguments\"\": {\"\"table\"\": \"\"tblH7TnJxYpNqhQYK\"\", \"\"fields\"\": {\"\"Name\"\": \"\"Simple Test\"\"}}}}'' \\\n  > /tmp/raw_response.txt\n\n# Extract record ID using grep\nRECORD_ID=$(cat /tmp/raw_response.txt | grep -o ''rec[a-zA-Z0-9]\\{10,20\\}'' | head -1)\necho \"\"Extracted ID: $RECORD_ID\"\"\n\nif [ ! -z \"\"$RECORD_ID\"\" ]; then\n  echo \"\"✅ Got record ID: $RECORD_ID\"\"\nelse\n  echo \"\"❌ Failed to extract ID\"\"\n  cat /tmp/raw_response.txt | od -c | head -20\nfi)",
-      "Bash(# Add debug logging to see the exact API call\nexport LOG_LEVEL=DEBUG\npkill -f \"\"node.*airtable\"\" 2>/dev/null; sleep 1\nexport AIRTABLE_TOKEN=\"\"patSDGN40NJd9G8E4.9fee82826ee482d6556480d004592e5f806bd8e95cef18fc5ba2d7fc55274367\"\"\nexport AIRTABLE_BASE_ID=\"\"appTV04Fyu1Gvbunq\"\"\nnode airtable_simple.js > /tmp/server_debug.log 2>&1 &\npid=$!\nsleep 2\n\n# Test webhook creation with debug\ncurl -s -X POST http://localhost:8010/mcp \\\n  -H \"\"Content-Type: application/json\"\" \\\n  -d ''{\"\"jsonrpc\"\": \"\"2.0\"\", \"\"id\"\": 1, \"\"method\"\": \"\"tools/call\"\", \"\"params\"\": {\"\"name\"\": \"\"create_webhook\"\", \"\"arguments\"\": {\"\"notificationUrl\"\": \"\"https://webhook.site/debug-test\"\"}}}'' > /dev/null\n\n# Check debug log\necho \"\"Debug output:\"\"\ngrep -A 2 \"\"API Request.*webhook\"\" /tmp/server_debug.log | tail -5)",
-      "Bash(./test_all_features.sh:*)"
-    ],
-    "deny": []
-  }
-}