@rashidazarang/airtable-mcp 2.1.0 → 2.1.1

package/monitoring/alerts.yml

@@ -1,289 +0,0 @@
-# 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

@@ -1,224 +0,0 @@
-# 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/publish-steps.txt

@@ -1,27 +0,0 @@
-# Steps to Publish to npm
-
-## 1. Login to npm
-```
-npm login
-```
-
-## 2. Publish the package
-```
-npm publish --access public
-```
-
-## 3. Create GitHub Release
-1. Go to https://github.com/rashidazarang/airtable-mcp/releases
-2. Click "Draft a new release"
-3. Select the tag: v1.2.0
-4. Title: "v1.2.0: Claude & Windsurf Compatibility"
-5. Copy and paste the content from RELEASE_NOTES_v1.2.0.md
-6. Attach the file: rashidazarang-airtable-mcp-1.2.0.tgz
-7. Click "Publish release"
-
-## 4. Update Smithery
-If you use Smithery, make sure to update the repository there:
-1. Login to Smithery
-2. Go to your package
-3. Update the version information
-4. Publish the update 

package/quick_test.sh

@@ -1,30 +0,0 @@
-#!/bin/bash
-
-echo "🔌 Airtable MCP Quick Tests"
-echo "==========================="
-
-# Test 1: List Tables
-echo "📊 Testing: List Tables"
-curl -s -X POST http://localhost:8010/mcp \
-  -H "Content-Type: application/json" \
-  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "list_tables"}}' | jq '.result.content[0].text'
-
-echo -e "\n"
-
-# Test 2: List Records from Requests
-echo "📄 Testing: List Records (Requests)"
-curl -s -X POST http://localhost:8010/mcp \
-  -H "Content-Type: application/json" \
-  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "list_records", "arguments": {"table_name": "requests", "max_records": 2}}}' | jq '.result.content[0].text'
-
-echo -e "\n"
-
-# Test 3: List Records from Providers
-echo "👥 Testing: List Records (Providers)"
-curl -s -X POST http://localhost:8010/mcp \
-  -H "Content-Type: application/json" \
-  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "list_records", "arguments": {"table_name": "providers", "max_records": 2}}}' | jq '.result.content[0].text'
-
-echo -e "\n✅ All quick tests completed!"
-
-

package/requirements.txt

@@ -1,10 +0,0 @@
-airtable-python-wrapper>=0.15.3
-anthropic>=0.19.1
-argparse>=1.4.0
-python-dotenv>=1.0.0
-pydantic>=2.4.2
-# MCP core will be installed by Smithery during deployment
-requests>=2.31.0
-typing-extensions>=4.7.1
-websockets>=11.0.3
-mcp>=1.4.1 

package/setup.py

@@ -1,29 +0,0 @@
-#!/usr/bin/env python3
-
-from setuptools import setup, find_packages
-
-with open("README.md", "r", encoding="utf-8") as fh:
-    long_description = fh.read()
-
-with open("requirements.txt", "r", encoding="utf-8") as req_file:
-    requirements = req_file.read().splitlines()
-
-setup(
-    name="airtable-mcp",
-    version="1.1.0",
-    author="Rashid Azarang",
-    author_email="rashidazarang@gmail.com",
-    description="Airtable MCP for AI tools - updated to work with MCP SDK 1.4.1+",
-    long_description=long_description,
-    long_description_content_type="text/markdown",
-    url="https://github.com/rashidazarang/airtable-mcp",
-    packages=find_packages(),
-    install_requires=requirements,
-    classifiers=[
-        "Programming Language :: Python :: 3.10",
-        "License :: OSI Approved :: MIT License",
-        "Operating System :: OS Independent",
-    ],
-    python_requires=">=3.10",
-    include_package_data=True,
-)