@rashidazarang/airtable-mcp 1.2.1 → 1.4.0

package/test_all_operations.sh

@@ -0,0 +1,120 @@
+#!/bin/bash
+
+echo "🧪 COMPREHENSIVE TEST OF AIRTABLE MCP v1.3.0"
+echo "============================================"
+echo ""
+
+# Configuration
+BASE_ID="appTV04Fyu1Gvbunq"
+TABLE_ID="tblH7TnJxYpNqhQYK"
+CREATED_RECORD_ID=""
+
+# Helper function for API calls
+call_mcp() {
+    local tool_name=$1
+    local args=$2
+    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}}"
+}
+
+# Test 1: List tables
+echo "1️⃣  TEST: list_tables"
+echo "---------------------"
+result=$(call_mcp "list_tables" "{}")
+if echo "$result" | grep -q "Found.*table"; then
+    echo "✅ PASSED: Tables listed successfully"
+    echo "$result" | python3 -c "import sys, json; print(json.load(sys.stdin)['result']['content'][0]['text'][:200])"
+else
+    echo "❌ FAILED: Could not list tables"
+fi
+echo ""
+
+# Test 2: Create record
+echo "2️⃣  TEST: create_record"
+echo "----------------------"
+result=$(call_mcp "create_record" "{\"table\": \"$TABLE_ID\", \"fields\": {\"Name\": \"Test Record $(date +%s)\", \"Notes\": \"Created by test suite\", \"Status\": \"Testing\"}}")
+if echo "$result" | grep -q "Successfully created"; then
+    echo "✅ PASSED: Record created successfully"
+    CREATED_RECORD_ID=$(echo "$result" | grep -o 'rec[a-zA-Z0-9]*' | head -1)
+    echo "   Created Record ID: $CREATED_RECORD_ID"
+else
+    echo "❌ FAILED: Could not create record"
+    echo "$result" | python3 -m json.tool
+fi
+echo ""
+
+# Test 3: Get record
+echo "3️⃣  TEST: get_record"
+echo "-------------------"
+if [ ! -z "$CREATED_RECORD_ID" ]; then
+    result=$(call_mcp "get_record" "{\"table\": \"$TABLE_ID\", \"recordId\": \"$CREATED_RECORD_ID\"}")
+    if echo "$result" | grep -q "Record $CREATED_RECORD_ID"; then
+        echo "✅ PASSED: Record retrieved successfully"
+        echo "$result" | python3 -c "import sys, json; print(json.load(sys.stdin)['result']['content'][0]['text'][:200])"
+    else
+        echo "❌ FAILED: Could not retrieve record"
+    fi
+else
+    echo "⚠️  SKIPPED: No record ID available"
+fi
+echo ""
+
+# Test 4: Update record
+echo "4️⃣  TEST: update_record"
+echo "----------------------"
+if [ ! -z "$CREATED_RECORD_ID" ]; then
+    result=$(call_mcp "update_record" "{\"table\": \"$TABLE_ID\", \"recordId\": \"$CREATED_RECORD_ID\", \"fields\": {\"Status\": \"Updated\", \"Notes\": \"Updated at $(date)\"}}")
+    if echo "$result" | grep -q "Successfully updated"; then
+        echo "✅ PASSED: Record updated successfully"
+    else
+        echo "❌ FAILED: Could not update record"
+    fi
+else
+    echo "⚠️  SKIPPED: No record ID available"
+fi
+echo ""
+
+# Test 5: Search records
+echo "5️⃣  TEST: search_records"
+echo "-----------------------"
+result=$(call_mcp "search_records" "{\"table\": \"$TABLE_ID\", \"maxRecords\": 5}")
+if echo "$result" | grep -q "Found.*record\\|No records"; then
+    echo "✅ PASSED: Search executed successfully"
+    echo "$result" | python3 -c "import sys, json; t=json.load(sys.stdin)['result']['content'][0]['text']; print(t[:200] if len(t)>200 else t)"
+else
+    echo "❌ FAILED: Search failed"
+fi
+echo ""
+
+# Test 6: List records
+echo "6️⃣  TEST: list_records"
+echo "---------------------"
+result=$(call_mcp "list_records" "{\"table\": \"$TABLE_ID\", \"maxRecords\": 3}")
+if echo "$result" | grep -q "record\\|No records"; then
+    echo "✅ PASSED: Records listed successfully"
+    count=$(echo "$result" | grep -o "ID: rec" | wc -l)
+    echo "   Found $count records"
+else
+    echo "❌ FAILED: Could not list records"
+fi
+echo ""
+
+# Test 7: Delete record
+echo "7️⃣  TEST: delete_record"
+echo "----------------------"
+if [ ! -z "$CREATED_RECORD_ID" ]; then
+    result=$(call_mcp "delete_record" "{\"table\": \"$TABLE_ID\", \"recordId\": \"$CREATED_RECORD_ID\"}")
+    if echo "$result" | grep -q "Successfully deleted"; then
+        echo "✅ PASSED: Record deleted successfully"
+    else
+        echo "❌ FAILED: Could not delete record"
+    fi
+else
+    echo "⚠️  SKIPPED: No record ID available"
+fi
+echo ""
+
+echo "📊 TEST SUMMARY"
+echo "=============="
+echo "All 7 tools tested with real Airtable API"

package/test_client.py

@@ -4,14 +4,21 @@ Simple test client for Airtable MCP
 """
 import asyncio
 import json
+import os
 import sys
 import subprocess
 import time
 from typing import Dict, Any
 
-# Define the token and base ID
-TOKEN = "patnWSCSCmnsqeQ4I.2a3603372f6df67e51f9fe553012192019f2d81c3eab0f94ebd702d7fb63e338"
-BASE_ID = "appi7fWMQcB3BNzPs"
+# Load credentials from environment variables
+TOKEN = os.environ.get('AIRTABLE_TOKEN', 'YOUR_AIRTABLE_TOKEN_HERE')
+BASE_ID = os.environ.get('AIRTABLE_BASE_ID', 'YOUR_BASE_ID_HERE')
+
+if TOKEN == 'YOUR_AIRTABLE_TOKEN_HERE' or BASE_ID == 'YOUR_BASE_ID_HERE':
+    print("Error: Please set AIRTABLE_TOKEN and AIRTABLE_BASE_ID environment variables")
+    print("Example: export AIRTABLE_TOKEN=your_token_here")
+    print("         export AIRTABLE_BASE_ID=your_base_id_here")
+    sys.exit(1)
 
 # Helper function to directly make Airtable API calls
 def api_call(endpoint, token=TOKEN):

package/test_enhanced_features.js

@@ -0,0 +1,389 @@
+#!/usr/bin/env node
+
+/**
+ * Test Script for Enhanced Airtable MCP v1.3.0
+ * Tests all CRUD operations and new features
+ */
+
+const http = require('http');
+
+// Test configuration - using environment variables
+const MCP_SERVER_URL = 'http://localhost:8010/mcp';
+const TEST_TOKEN = process.env.AIRTABLE_TOKEN || 'YOUR_AIRTABLE_TOKEN';
+const TEST_BASE_ID = process.env.AIRTABLE_BASE_ID || 'YOUR_BASE_ID';
+
+if (TEST_TOKEN === 'YOUR_AIRTABLE_TOKEN' || TEST_BASE_ID === 'YOUR_BASE_ID') {
+  console.error('❌ Error: Please set AIRTABLE_TOKEN and AIRTABLE_BASE_ID environment variables');
+  console.error('Example:');
+  console.error('  export AIRTABLE_TOKEN=your_token_here');
+  console.error('  export AIRTABLE_BASE_ID=your_base_id_here');
+  process.exit(1);
+}
+
+// Test data
+let createdRecordId = null;
+const testTableName = 'Tasks'; // Change this to your actual table name
+
+// Helper function to make MCP requests
+function makeMCPRequest(method, params = {}) {
+  return new Promise((resolve, reject) => {
+    const postData = JSON.stringify({
+      jsonrpc: '2.0',
+      id: Date.now(),
+      method: method,
+      params: params
+    });
+
+    const options = {
+      hostname: 'localhost',
+      port: 8010,
+      path: '/mcp',
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Content-Length': Buffer.byteLength(postData)
+      }
+    };
+
+    const req = http.request(options, (res) => {
+      let data = '';
+      res.on('data', (chunk) => {
+        data += chunk;
+      });
+      res.on('end', () => {
+        try {
+          const response = JSON.parse(data);
+          resolve(response);
+        } catch (e) {
+          reject(new Error(`Failed to parse response: ${e.message}\nRaw data: ${data}`));
+        }
+      });
+    });
+
+    req.on('error', (e) => {
+      reject(new Error(`Request failed: ${e.message}`));
+    });
+
+    req.write(postData);
+    req.end();
+  });
+}
+
+// Test functions
+async function testListTools() {
+  console.log('\n📋 TEST 1: List Available Tools');
+  console.log('================================');
+  
+  try {
+    const response = await makeMCPRequest('tools/list');
+    
+    if (response.result && response.result.tools) {
+      console.log(`✅ Found ${response.result.tools.length} tools:`);
+      response.result.tools.forEach(tool => {
+        console.log(`   - ${tool.name}: ${tool.description}`);
+      });
+      return true;
+    } else {
+      console.error('❌ No tools found in response');
+      return false;
+    }
+  } catch (error) {
+    console.error('❌ Error:', error.message);
+    return false;
+  }
+}
+
+async function testListTables() {
+  console.log('\n📊 TEST 2: List Tables');
+  console.log('======================');
+  
+  try {
+    const response = await makeMCPRequest('tools/call', {
+      name: 'list_tables'
+    });
+    
+    if (response.result && response.result.content) {
+      console.log('✅ Response:', response.result.content[0].text);
+      return true;
+    } else {
+      console.error('❌ No content in response');
+      return false;
+    }
+  } catch (error) {
+    console.error('❌ Error:', error.message);
+    return false;
+  }
+}
+
+async function testCreateRecord() {
+  console.log('\n➕ TEST 3: Create Record');
+  console.log('========================');
+  
+  try {
+    const response = await makeMCPRequest('tools/call', {
+      name: 'create_record',
+      arguments: {
+        table: testTableName,
+        fields: {
+          'Name': 'Test Task from MCP v1.3.0',
+          'Notes': 'This is a test record created by the enhanced MCP',
+          'Status': 'In progress'
+        }
+      }
+    });
+    
+    if (response.result && response.result.content) {
+      console.log('✅ Created record:', response.result.content[0].text);
+      
+      // Extract record ID from response
+      const match = response.result.content[0].text.match(/Record ID: (rec\w+)/);
+      if (match) {
+        createdRecordId = match[1];
+        console.log(`📝 Saved record ID: ${createdRecordId}`);
+      }
+      return true;
+    } else {
+      console.error('❌ Failed to create record');
+      return false;
+    }
+  } catch (error) {
+    console.error('❌ Error:', error.message);
+    return false;
+  }
+}
+
+async function testGetRecord() {
+  console.log('\n🔍 TEST 4: Get Single Record');
+  console.log('=============================');
+  
+  if (!createdRecordId) {
+    console.log('⚠️  Skipping: No record ID available');
+    return false;
+  }
+  
+  try {
+    const response = await makeMCPRequest('tools/call', {
+      name: 'get_record',
+      arguments: {
+        table: testTableName,
+        recordId: createdRecordId
+      }
+    });
+    
+    if (response.result && response.result.content) {
+      console.log('✅ Retrieved record:', response.result.content[0].text);
+      return true;
+    } else {
+      console.error('❌ Failed to retrieve record');
+      return false;
+    }
+  } catch (error) {
+    console.error('❌ Error:', error.message);
+    return false;
+  }
+}
+
+async function testUpdateRecord() {
+  console.log('\n✏️  TEST 5: Update Record');
+  console.log('=========================');
+  
+  if (!createdRecordId) {
+    console.log('⚠️  Skipping: No record ID available');
+    return false;
+  }
+  
+  try {
+    const response = await makeMCPRequest('tools/call', {
+      name: 'update_record',
+      arguments: {
+        table: testTableName,
+        recordId: createdRecordId,
+        fields: {
+          'Status': 'Done',
+          'Notes': 'Updated by MCP test suite at ' + new Date().toISOString()
+        }
+      }
+    });
+    
+    if (response.result && response.result.content) {
+      console.log('✅ Updated record:', response.result.content[0].text);
+      return true;
+    } else {
+      console.error('❌ Failed to update record');
+      return false;
+    }
+  } catch (error) {
+    console.error('❌ Error:', error.message);
+    return false;
+  }
+}
+
+async function testSearchRecords() {
+  console.log('\n🔎 TEST 6: Search Records');
+  console.log('=========================');
+  
+  try {
+    const response = await makeMCPRequest('tools/call', {
+      name: 'search_records',
+      arguments: {
+        table: testTableName,
+        filterByFormula: "{Status} = 'Done'",
+        maxRecords: 5,
+        sort: [{field: 'Name', direction: 'asc'}]
+      }
+    });
+    
+    if (response.result && response.result.content) {
+      console.log('✅ Search results:', response.result.content[0].text);
+      return true;
+    } else {
+      console.error('❌ No search results');
+      return false;
+    }
+  } catch (error) {
+    console.error('❌ Error:', error.message);
+    return false;
+  }
+}
+
+async function testListRecords() {
+  console.log('\n📝 TEST 7: List Records');
+  console.log('=======================');
+  
+  try {
+    const response = await makeMCPRequest('tools/call', {
+      name: 'list_records',
+      arguments: {
+        table: testTableName,
+        maxRecords: 3
+      }
+    });
+    
+    if (response.result && response.result.content) {
+      console.log('✅ Listed records:', response.result.content[0].text.substring(0, 200) + '...');
+      return true;
+    } else {
+      console.error('❌ Failed to list records');
+      return false;
+    }
+  } catch (error) {
+    console.error('❌ Error:', error.message);
+    return false;
+  }
+}
+
+async function testDeleteRecord() {
+  console.log('\n🗑️  TEST 8: Delete Record');
+  console.log('=========================');
+  
+  if (!createdRecordId) {
+    console.log('⚠️  Skipping: No record ID available');
+    return false;
+  }
+  
+  try {
+    const response = await makeMCPRequest('tools/call', {
+      name: 'delete_record',
+      arguments: {
+        table: testTableName,
+        recordId: createdRecordId
+      }
+    });
+    
+    if (response.result && response.result.content) {
+      console.log('✅ Deleted record:', response.result.content[0].text);
+      return true;
+    } else {
+      console.error('❌ Failed to delete record');
+      return false;
+    }
+  } catch (error) {
+    console.error('❌ Error:', error.message);
+    return false;
+  }
+}
+
+// Main test runner
+async function runTests() {
+  console.log('🚀 Enhanced Airtable MCP v1.3.0 Test Suite');
+  console.log('==========================================');
+  console.log(`📍 Testing server at: ${MCP_SERVER_URL}`);
+  console.log(`🔑 Token: ${TEST_TOKEN.slice(0, 5)}...${TEST_TOKEN.slice(-5)}`);
+  console.log(`📦 Base ID: ${TEST_BASE_ID}`);
+  console.log(`📊 Test table: ${testTableName}`);
+  
+  const tests = [
+    { name: 'List Tools', fn: testListTools },
+    { name: 'List Tables', fn: testListTables },
+    { name: 'Create Record', fn: testCreateRecord },
+    { name: 'Get Record', fn: testGetRecord },
+    { name: 'Update Record', fn: testUpdateRecord },
+    { name: 'Search Records', fn: testSearchRecords },
+    { name: 'List Records', fn: testListRecords },
+    { name: 'Delete Record', fn: testDeleteRecord }
+  ];
+  
+  let passed = 0;
+  let failed = 0;
+  
+  for (const test of tests) {
+    try {
+      const result = await test.fn();
+      if (result) {
+        passed++;
+      } else {
+        failed++;
+      }
+    } catch (error) {
+      console.error(`❌ Test "${test.name}" crashed:`, error.message);
+      failed++;
+    }
+    
+    // Small delay between tests
+    await new Promise(resolve => setTimeout(resolve, 1000));
+  }
+  
+  console.log('\n' + '='.repeat(50));
+  console.log('📊 TEST RESULTS SUMMARY');
+  console.log('='.repeat(50));
+  console.log(`✅ Passed: ${passed}/${tests.length}`);
+  console.log(`❌ Failed: ${failed}/${tests.length}`);
+  console.log(`📈 Success Rate: ${Math.round((passed/tests.length) * 100)}%`);
+  
+  if (failed === 0) {
+    console.log('\n🎉 All tests passed! The enhanced MCP is working perfectly!');
+  } else {
+    console.log('\n⚠️  Some tests failed. Please check the errors above.');
+  }
+  
+  process.exit(failed === 0 ? 0 : 1);
+}
+
+// Check if server is running
+async function checkServer() {
+  try {
+    await makeMCPRequest('tools/list');
+    return true;
+  } catch (error) {
+    return false;
+  }
+}
+
+// Main
+(async () => {
+  console.log('🔍 Checking if MCP server is running...');
+  
+  const serverRunning = await checkServer();
+  
+  if (!serverRunning) {
+    console.error('❌ MCP server is not running at ' + MCP_SERVER_URL);
+    console.error('\nPlease start the server first:');
+    console.error('  node airtable_enhanced.js --token YOUR_TOKEN --base YOUR_BASE_ID');
+    process.exit(1);
+  }
+  
+  console.log('✅ Server is running!\n');
+  
+  // Run tests
+  await runTests();
+})();

package/test_mcp_comprehensive.js

@@ -0,0 +1,162 @@
+#!/usr/bin/env node
+
+/**
+ * Comprehensive Test Script for Airtable MCP
+ * Tests all available MCP tools and functionality
+ */
+
+const http = require('http');
+
+const MCP_SERVER_URL = 'http://localhost:8010/mcp';
+const TEST_TOKEN = process.env.AIRTABLE_TOKEN || 'YOUR_AIRTABLE_TOKEN_HERE';
+const TEST_BASE_ID = process.env.AIRTABLE_BASE_ID || 'YOUR_BASE_ID_HERE';
+
+if (TEST_TOKEN === 'YOUR_AIRTABLE_TOKEN_HERE' || TEST_BASE_ID === 'YOUR_BASE_ID_HERE') {
+  console.error('Error: Please set AIRTABLE_TOKEN and AIRTABLE_BASE_ID environment variables');
+  console.error('Example: export AIRTABLE_TOKEN=your_token_here');
+  console.error('         export AIRTABLE_BASE_ID=your_base_id_here');
+  process.exit(1);
+}
+
+// Helper function to make MCP requests
+function makeMCPRequest(method, params = {}) {
+  return new Promise((resolve, reject) => {
+    const postData = JSON.stringify({
+      jsonrpc: '2.0',
+      id: Date.now(),
+      method: method,
+      params: params
+    });
+
+    const options = {
+      hostname: 'localhost',
+      port: 8010,
+      path: '/mcp',
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Content-Length': Buffer.byteLength(postData)
+      }
+    };
+
+    const req = http.request(options, (res) => {
+      let data = '';
+      res.on('data', (chunk) => {
+        data += chunk;
+      });
+      res.on('end', () => {
+        try {
+          const response = JSON.parse(data);
+          resolve(response);
+        } catch (e) {
+          reject(new Error(`Failed to parse response: ${e.message}`));
+        }
+      });
+    });
+
+    req.on('error', (e) => {
+      reject(new Error(`Request failed: ${e.message}`));
+    });
+
+    req.write(postData);
+    req.end();
+  });
+}
+
+async function runComprehensiveTest() {
+  console.log('🔌 Airtable MCP Comprehensive Test');
+  console.log('===================================');
+  console.log(`Server: ${MCP_SERVER_URL}`);
+  console.log(`Base ID: ${TEST_BASE_ID}`);
+  console.log(`Token: ${TEST_TOKEN.substring(0, 10)}...${TEST_TOKEN.substring(TEST_TOKEN.length - 10)}`);
+  console.log('');
+
+  try {
+    // Test 1: List Resources
+    console.log('📋 Test 1: Listing Resources');
+    console.log('----------------------------');
+    const resourcesResponse = await makeMCPRequest('resources/list');
+    console.log('✅ Resources Response:');
+    console.log(JSON.stringify(resourcesResponse, null, 2));
+    console.log('');
+
+    // Test 2: List Prompts
+    console.log('📝 Test 2: Listing Prompts');
+    console.log('-------------------------');
+    const promptsResponse = await makeMCPRequest('prompts/list');
+    console.log('✅ Prompts Response:');
+    console.log(JSON.stringify(promptsResponse, null, 2));
+    console.log('');
+
+    // Test 3: List Tables
+    console.log('📊 Test 3: Listing Tables');
+    console.log('------------------------');
+    const tablesResponse = await makeMCPRequest('tools/call', {
+      name: 'list_tables'
+    });
+    console.log('✅ Tables Response:');
+    console.log(JSON.stringify(tablesResponse, null, 2));
+    console.log('');
+
+    // Test 4: List Records from Requests table
+    console.log('📄 Test 4: Listing Records (Requests Table)');
+    console.log('-------------------------------------------');
+    const recordsResponse = await makeMCPRequest('tools/call', {
+      name: 'list_records',
+      arguments: {
+        table_name: 'requests',
+        max_records: 3
+      }
+    });
+    console.log('✅ Records Response:');
+    console.log(JSON.stringify(recordsResponse, null, 2));
+    console.log('');
+
+    // Test 5: List Records from Providers table
+    console.log('👥 Test 5: Listing Records (Providers Table)');
+    console.log('--------------------------------------------');
+    const providersResponse = await makeMCPRequest('tools/call', {
+      name: 'list_records',
+      arguments: {
+        table_name: 'providers',
+        max_records: 3
+      }
+    });
+    console.log('✅ Providers Response:');
+    console.log(JSON.stringify(providersResponse, null, 2));
+    console.log('');
+
+    // Test 6: List Records from Categories table
+    console.log('🏷️ Test 6: Listing Records (Categories Table)');
+    console.log('---------------------------------------------');
+    const categoriesResponse = await makeMCPRequest('tools/call', {
+      name: 'list_records',
+      arguments: {
+        table_name: 'categories',
+        max_records: 3
+      }
+    });
+    console.log('✅ Categories Response:');
+    console.log(JSON.stringify(categoriesResponse, null, 2));
+    console.log('');
+
+    console.log('🎉 All Tests Completed Successfully!');
+    console.log('');
+    console.log('📊 Test Summary:');
+    console.log('✅ MCP Server is running and accessible');
+    console.log('✅ Airtable API connection is working');
+    console.log('✅ All MCP tools are functioning properly');
+    console.log('✅ JSON-RPC protocol is correctly implemented');
+    console.log('✅ Error handling is working');
+    console.log('');
+    console.log('🚀 The Airtable MCP is ready for use!');
+
+  } catch (error) {
+    console.error('❌ Test failed:', error.message);
+    process.exit(1);
+  }
+}
+
+// Run the comprehensive test
+runComprehensiveTest();
+