@rashidazarang/airtable-mcp 1.2.4 → 1.4.0

package/test_mock_server.js

@@ -0,0 +1,180 @@
+#!/usr/bin/env node
+
+/**
+ * Mock Airtable API Server for Testing
+ * Simulates Airtable API responses for testing the MCP
+ */
+
+const http = require('http');
+const https = require('https');
+
+// Mock data store
+let mockTables = {
+  'tblTest123': {
+    id: 'tblTest123',
+    name: 'Tasks',
+    fields: [
+      { id: 'fld1', name: 'Name', type: 'singleLineText' },
+      { id: 'fld2', name: 'Status', type: 'singleSelect' },
+      { id: 'fld3', name: 'Notes', type: 'multilineText' }
+    ]
+  },
+  'tblTest456': {
+    id: 'tblTest456', 
+    name: 'Projects',
+    fields: [
+      { id: 'fld4', name: 'Title', type: 'singleLineText' },
+      { id: 'fld5', name: 'Description', type: 'multilineText' }
+    ]
+  }
+};
+
+let mockRecords = {
+  'tblTest123': [
+    {
+      id: 'recABC123',
+      fields: { Name: 'Test Task 1', Status: 'Todo', Notes: 'First test task' },
+      createdTime: '2025-08-14T10:00:00.000Z'
+    },
+    {
+      id: 'recDEF456',
+      fields: { Name: 'Test Task 2', Status: 'In Progress', Notes: 'Second test task' },
+      createdTime: '2025-08-14T11:00:00.000Z'
+    }
+  ],
+  'tblTest456': []
+};
+
+let recordIdCounter = 1000;
+
+// Create mock server
+const server = http.createServer((req, res) => {
+  console.log(`Mock API: ${req.method} ${req.url}`);
+  
+  // Parse URL
+  const url = req.url;
+  
+  // Enable CORS
+  res.setHeader('Access-Control-Allow-Origin', '*');
+  res.setHeader('Access-Control-Allow-Methods', 'GET, POST, PATCH, DELETE, OPTIONS');
+  res.setHeader('Access-Control-Allow-Headers', 'Authorization, Content-Type');
+  
+  // Check authorization
+  if (!req.headers.authorization || !req.headers.authorization.includes('Bearer')) {
+    res.writeHead(401, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ error: { type: 'UNAUTHORIZED', message: 'Missing authorization' } }));
+    return;
+  }
+  
+  // Handle preflight
+  if (req.method === 'OPTIONS') {
+    res.writeHead(200);
+    res.end();
+    return;
+  }
+  
+  // Route handlers
+  if (url.includes('/v0/meta/bases/') && url.includes('/tables')) {
+    // List tables
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ tables: Object.values(mockTables) }));
+    
+  } else if (req.method === 'GET' && url.match(/\/v0\/test_base\/(tbl\w+)$/)) {
+    // List records
+    const tableId = url.match(/\/(tbl\w+)$/)[1];
+    const records = mockRecords[tableId] || [];
+    
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ records }));
+    
+  } else if (req.method === 'GET' && url.match(/\/v0\/test_base\/(tbl\w+)\/(rec\w+)$/)) {
+    // Get single record
+    const matches = url.match(/\/(tbl\w+)\/(rec\w+)$/);
+    const tableId = matches[1];
+    const recordId = matches[2];
+    
+    const records = mockRecords[tableId] || [];
+    const record = records.find(r => r.id === recordId);
+    
+    if (record) {
+      res.writeHead(200, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify(record));
+    } else {
+      res.writeHead(404, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({ error: { type: 'NOT_FOUND', message: 'Record not found' } }));
+    }
+    
+  } else if (req.method === 'POST' && url.match(/\/v0\/test_base\/(tbl\w+)$/)) {
+    // Create record
+    const tableId = url.match(/\/(tbl\w+)$/)[1];
+    
+    let body = '';
+    req.on('data', chunk => body += chunk);
+    req.on('end', () => {
+      const data = JSON.parse(body);
+      const newRecord = {
+        id: `recNEW${recordIdCounter++}`,
+        fields: data.fields,
+        createdTime: new Date().toISOString()
+      };
+      
+      if (!mockRecords[tableId]) mockRecords[tableId] = [];
+      mockRecords[tableId].push(newRecord);
+      
+      res.writeHead(200, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify(newRecord));
+    });
+    
+  } else if (req.method === 'PATCH' && url.match(/\/v0\/test_base\/(tbl\w+)\/(rec\w+)$/)) {
+    // Update record
+    const matches = url.match(/\/(tbl\w+)\/(rec\w+)$/);
+    const tableId = matches[1];
+    const recordId = matches[2];
+    
+    let body = '';
+    req.on('data', chunk => body += chunk);
+    req.on('end', () => {
+      const data = JSON.parse(body);
+      const records = mockRecords[tableId] || [];
+      const record = records.find(r => r.id === recordId);
+      
+      if (record) {
+        Object.assign(record.fields, data.fields);
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify(record));
+      } else {
+        res.writeHead(404, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: { type: 'NOT_FOUND', message: 'Record not found' } }));
+      }
+    });
+    
+  } else if (req.method === 'DELETE' && url.match(/\/v0\/test_base\/(tbl\w+)\/(rec\w+)$/)) {
+    // Delete record
+    const matches = url.match(/\/(tbl\w+)\/(rec\w+)$/);
+    const tableId = matches[1];
+    const recordId = matches[2];
+    
+    const records = mockRecords[tableId] || [];
+    const index = records.findIndex(r => r.id === recordId);
+    
+    if (index !== -1) {
+      records.splice(index, 1);
+      res.writeHead(200, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({ id: recordId, deleted: true }));
+    } else {
+      res.writeHead(404, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({ error: { type: 'NOT_FOUND', message: 'Record not found' } }));
+    }
+    
+  } else {
+    res.writeHead(404, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ error: { type: 'NOT_FOUND', message: 'Endpoint not found' } }));
+  }
+});
+
+// Start mock server on port 8888
+server.listen(8888, () => {
+  console.log('🎭 Mock Airtable API server running on http://localhost:8888');
+  console.log('📋 Mock tables: Tasks (tblTest123), Projects (tblTest456)');
+  console.log('📝 Mock records: 2 in Tasks, 0 in Projects');
+});

package/test_v1.4.0_final.sh

@@ -0,0 +1,131 @@
+#!/bin/bash
+
+echo "🚀 FINAL TEST SUITE FOR AIRTABLE MCP v1.4.0"
+echo "==========================================="
+echo ""
+
+PASSED=0
+FAILED=0
+
+# Helper function to test a tool
+test_tool() {
+    local tool_name=$1
+    local args=$2
+    local expected=$3
+    
+    result=$(curl -s -X POST http://localhost:8010/mcp \
+        -H "Content-Type: application/json" \
+        -d "{\"jsonrpc\": \"2.0\", \"id\": 1, \"method\": \"tools/call\", \"params\": {\"name\": \"$tool_name\", \"arguments\": $args}}")
+    
+    if echo "$result" | grep -q "$expected"; then
+        echo "✅ $tool_name: PASSED"
+        ((PASSED++))
+        return 0
+    else
+        echo "❌ $tool_name: FAILED"
+        echo "   Response: $(echo "$result" | python3 -c "import sys, json; r=json.load(sys.stdin); print(r.get('result', {}).get('content', [{}])[0].get('text', 'ERROR')[:100])")"
+        ((FAILED++))
+        return 1
+    fi
+}
+
+echo "📋 Testing 12 Tools"
+echo "==================="
+echo ""
+
+# 1. List tools
+echo -n "1. Tools available: "
+tools_count=$(curl -s -X POST http://localhost:8010/mcp \
+    -H "Content-Type: application/json" \
+    -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' \
+    | python3 -c "import sys, json; print(len(json.load(sys.stdin)['result']['tools']))")
+echo "$tools_count tools"
+
+# 2. List tables
+test_tool "list_tables" "{}" "table"
+
+# 3. Create record
+RECORD_JSON=$(curl -s -X POST http://localhost:8010/mcp \
+    -H "Content-Type: application/json" \
+    -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "create_record", "arguments": {"table": "tblH7TnJxYpNqhQYK", "fields": {"Name": "Test v1.4.0", "Status": "Testing"}}}}')
+    
+if echo "$RECORD_JSON" | grep -q "Successfully created"; then
+    echo "✅ create_record: PASSED"
+    ((PASSED++))
+    RECORD_ID=$(echo "$RECORD_JSON" | grep -o 'rec[a-zA-Z0-9]\+' | head -1)
+else
+    echo "❌ create_record: FAILED"
+    ((FAILED++))
+    RECORD_ID=""
+fi
+
+# 4. Get record
+if [ ! -z "$RECORD_ID" ]; then
+    test_tool "get_record" "{\"table\": \"tblH7TnJxYpNqhQYK\", \"recordId\": \"$RECORD_ID\"}" "Record $RECORD_ID"
+fi
+
+# 5. Update record  
+if [ ! -z "$RECORD_ID" ]; then
+    test_tool "update_record" "{\"table\": \"tblH7TnJxYpNqhQYK\", \"recordId\": \"$RECORD_ID\", \"fields\": {\"Status\": \"Updated\"}}" "Successfully updated"
+fi
+
+# 6. List records
+test_tool "list_records" "{\"table\": \"tblH7TnJxYpNqhQYK\", \"maxRecords\": 2}" "record"
+
+# 7. Search records
+test_tool "search_records" "{\"table\": \"tblH7TnJxYpNqhQYK\", \"maxRecords\": 2}" "record"
+
+# 8. List webhooks  
+test_tool "list_webhooks" "{}" "webhook"
+
+# 9. Create webhook
+WEBHOOK_JSON=$(curl -s -X POST http://localhost:8010/mcp \
+    -H "Content-Type: application/json" \
+    -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "create_webhook", "arguments": {"notificationUrl": "https://webhook.site/unique-test-id"}}}')
+
+if echo "$WEBHOOK_JSON" | grep -q "Successfully created"; then
+    echo "✅ create_webhook: PASSED"
+    ((PASSED++))
+    WEBHOOK_ID=$(echo "$WEBHOOK_JSON" | grep -o 'ach[a-zA-Z0-9]\+' | head -1)
+else
+    echo "❌ create_webhook: FAILED"
+    ((FAILED++))
+    WEBHOOK_ID=""
+fi
+
+# 10. Get webhook payloads
+if [ ! -z "$WEBHOOK_ID" ]; then
+    test_tool "get_webhook_payloads" "{\"webhookId\": \"$WEBHOOK_ID\"}" "payload"
+fi
+
+# 11. Refresh webhook
+if [ ! -z "$WEBHOOK_ID" ]; then
+    test_tool "refresh_webhook" "{\"webhookId\": \"$WEBHOOK_ID\"}" "refreshed"
+fi
+
+# 12. Delete webhook
+if [ ! -z "$WEBHOOK_ID" ]; then
+    test_tool "delete_webhook" "{\"webhookId\": \"$WEBHOOK_ID\"}" "deleted"
+fi
+
+# 13. Delete record (cleanup)
+if [ ! -z "$RECORD_ID" ]; then
+    test_tool "delete_record" "{\"table\": \"tblH7TnJxYpNqhQYK\", \"recordId\": \"$RECORD_ID\"}" "Successfully deleted"
+fi
+
+echo ""
+echo "📊 TEST RESULTS"
+echo "=============="
+echo "✅ Passed: $PASSED"
+echo "❌ Failed: $FAILED"
+echo "📈 Success Rate: $(( PASSED * 100 / (PASSED + FAILED) ))%"
+
+if [ $FAILED -eq 0 ]; then
+    echo ""
+    echo "🎉 ALL TESTS PASSED! Ready for production!"
+    exit 0
+else
+    echo ""
+    echo "⚠️  Some tests failed. Please review before publishing."
+    exit 1
+fi

package/test_webhooks.sh

@@ -0,0 +1,105 @@
+#!/bin/bash
+
+echo "🪝 TESTING WEBHOOK FUNCTIONALITY"
+echo "================================"
+echo ""
+
+# Test 1: List webhooks
+echo "1️⃣  LIST WEBHOOKS"
+echo "-----------------"
+result=$(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_webhooks"}}')
+
+if echo "$result" | grep -q "webhook\\|No webhooks"; then
+  echo "✅ PASSED: list_webhooks working"
+  echo "$result" | python3 -c "import sys, json; print(json.load(sys.stdin)['result']['content'][0]['text'])"
+else
+  echo "❌ FAILED: list_webhooks error"
+  echo "$result" | python3 -m json.tool
+fi
+echo ""
+
+# Test 2: Create webhook
+echo "2️⃣  CREATE WEBHOOK"
+echo "------------------"
+result=$(curl -s -X POST http://localhost:8010/mcp \
+  -H "Content-Type: application/json" \
+  -d '{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "create_webhook", "arguments": {"notificationUrl": "https://webhook.site/test-webhook"}}}')
+
+if echo "$result" | grep -q "Successfully created webhook"; then
+  echo "✅ PASSED: create_webhook working"
+  # Extract webhook ID
+  WEBHOOK_ID=$(echo "$result" | grep -o 'ach[a-zA-Z0-9]*' | head -1)
+  echo "Created webhook ID: $WEBHOOK_ID"
+  echo "$result" | python3 -c "import sys, json; t=json.load(sys.stdin)['result']['content'][0]['text']; print(t[:300])"
+else
+  echo "❌ FAILED: create_webhook error"
+  echo "$result" | python3 -m json.tool | head -20
+fi
+echo ""
+
+# Test 3: List webhooks again
+echo "3️⃣  VERIFY WEBHOOK CREATED"
+echo "--------------------------"
+result=$(curl -s -X POST http://localhost:8010/mcp \
+  -H "Content-Type: application/json" \
+  -d '{"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": {"name": "list_webhooks"}}')
+
+if echo "$result" | grep -q "Found.*webhook"; then
+  echo "✅ PASSED: Webhook appears in list"
+  count=$(echo "$result" | grep -o "ID: ach" | wc -l)
+  echo "Total webhooks: $count"
+else
+  echo "⚠️  WARNING: No webhooks found"
+fi
+echo ""
+
+# Test 4: Get webhook payloads (if webhook exists)
+if [ ! -z "$WEBHOOK_ID" ]; then
+  echo "4️⃣  GET WEBHOOK PAYLOADS"
+  echo "------------------------"
+  result=$(curl -s -X POST http://localhost:8010/mcp \
+    -H "Content-Type: application/json" \
+    -d "{\"jsonrpc\": \"2.0\", \"id\": 4, \"method\": \"tools/call\", \"params\": {\"name\": \"get_webhook_payloads\", \"arguments\": {\"webhookId\": \"$WEBHOOK_ID\"}}}")
+  
+  if echo "$result" | grep -q "payload\\|No payloads"; then
+    echo "✅ PASSED: get_webhook_payloads working"
+  else
+    echo "❌ FAILED: get_webhook_payloads error"
+  fi
+  
+  # Test 5: Refresh webhook
+  echo ""
+  echo "5️⃣  REFRESH WEBHOOK"
+  echo "-------------------"
+  result=$(curl -s -X POST http://localhost:8010/mcp \
+    -H "Content-Type: application/json" \
+    -d "{\"jsonrpc\": \"2.0\", \"id\": 5, \"method\": \"tools/call\", \"params\": {\"name\": \"refresh_webhook\", \"arguments\": {\"webhookId\": \"$WEBHOOK_ID\"}}}")
+  
+  if echo "$result" | grep -q "Successfully refreshed"; then
+    echo "✅ PASSED: refresh_webhook working"
+  else
+    echo "❌ FAILED: refresh_webhook error"
+  fi
+  
+  # Test 6: Delete webhook
+  echo ""
+  echo "6️⃣  DELETE WEBHOOK"
+  echo "------------------"
+  result=$(curl -s -X POST http://localhost:8010/mcp \
+    -H "Content-Type: application/json" \
+    -d "{\"jsonrpc\": \"2.0\", \"id\": 6, \"method\": \"tools/call\", \"params\": {\"name\": \"delete_webhook\", \"arguments\": {\"webhookId\": \"$WEBHOOK_ID\"}}}")
+  
+  if echo "$result" | grep -q "Successfully deleted"; then
+    echo "✅ PASSED: delete_webhook working"
+  else
+    echo "❌ FAILED: delete_webhook error"
+    echo "$result" | python3 -m json.tool | head -20
+  fi
+fi
+
+echo ""
+echo "📊 WEBHOOK TEST SUMMARY"
+echo "======================"
+echo "Webhook operations tested with Airtable API"