@rashidazarang/airtable-mcp 1.6.0 → 2.1.1

package/README.md

@@ -1,6 +1,7 @@
 # Airtable MCP Server
 
 [![smithery badge](https://smithery.ai/badge/@rashidazarang/airtable-mcp)](https://smithery.ai/server/@rashidazarang/airtable-mcp)
+[![Trust Score](https://archestra.ai/badge/@rashidazarang/airtable-mcp)](https://archestra.ai/mcp-catalog/rashidazarang__airtable-mcp)
 ![Airtable](https://img.shields.io/badge/Airtable-18BFFF?style=for-the-badge&logo=Airtable&logoColor=white)
 [![MCP](https://img.shields.io/badge/MCP-1.6.0-green)](https://github.com/rashidazarang/airtable-mcp)
 

package/airtable_simple_production.js

@@ -0,0 +1,532 @@
+#!/usr/bin/env node
+
+/**
+ * Airtable MCP Server - Production Ready
+ * Model Context Protocol server for Airtable integration
+ * 
+ * Features:
+ * - Complete MCP 2024-11-05 protocol support
+ * - OAuth2 authentication with PKCE
+ * - Enterprise security features
+ * - Rate limiting and input validation
+ * - Production monitoring and health checks
+ * 
+ * Author: Rashid Azarang
+ * License: MIT
+ */
+
+const http = require('http');
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
+const url = require('url');
+const querystring = require('querystring');
+
+// Load environment variables
+const envPath = path.join(__dirname, '.env');
+if (fs.existsSync(envPath)) {
+  require('dotenv').config({ path: envPath });
+}
+
+// Parse command line arguments
+const args = process.argv.slice(2);
+let tokenIndex = args.indexOf('--token');
+let baseIndex = args.indexOf('--base');
+
+const token = tokenIndex !== -1 ? args[tokenIndex + 1] : process.env.AIRTABLE_TOKEN || process.env.AIRTABLE_API_TOKEN;
+const baseId = baseIndex !== -1 ? args[baseIndex + 1] : process.env.AIRTABLE_BASE_ID || process.env.AIRTABLE_BASE;
+
+if (!token || !baseId) {
+  console.error('Error: Missing Airtable credentials');
+  console.error('\nUsage options:');
+  console.error('  1. Command line: node airtable_simple_production.js --token YOUR_TOKEN --base YOUR_BASE_ID');
+  console.error('  2. Environment variables: AIRTABLE_TOKEN and AIRTABLE_BASE_ID');
+  console.error('  3. .env file with AIRTABLE_TOKEN and AIRTABLE_BASE_ID');
+  process.exit(1);
+}
+
+// Configuration
+const CONFIG = {
+  PORT: process.env.PORT || 8010,
+  HOST: process.env.HOST || 'localhost',
+  MAX_REQUESTS_PER_MINUTE: parseInt(process.env.MAX_REQUESTS_PER_MINUTE) || 60,
+  LOG_LEVEL: process.env.LOG_LEVEL || 'INFO'
+};
+
+// Logging
+const LOG_LEVELS = { ERROR: 0, WARN: 1, INFO: 2, DEBUG: 3, TRACE: 4 };
+const currentLogLevel = LOG_LEVELS[CONFIG.LOG_LEVEL] || LOG_LEVELS.INFO;
+
+function log(level, message, metadata = {}) {
+  if (level <= currentLogLevel) {
+    const timestamp = new Date().toISOString();
+    const levelName = Object.keys(LOG_LEVELS).find(key => LOG_LEVELS[key] === level);
+    const output = `[${timestamp}] [${levelName}] ${message}`;
+    
+    if (Object.keys(metadata).length > 0) {
+      console.log(output, JSON.stringify(metadata));
+    } else {
+      console.log(output);
+    }
+  }
+}
+
+// Rate limiting
+const rateLimiter = new Map();
+
+function checkRateLimit(clientId) {
+  const now = Date.now();
+  const windowStart = now - 60000; // 1 minute window
+  
+  if (!rateLimiter.has(clientId)) {
+    rateLimiter.set(clientId, []);
+  }
+  
+  const requests = rateLimiter.get(clientId);
+  const recentRequests = requests.filter(time => time > windowStart);
+  
+  if (recentRequests.length >= CONFIG.MAX_REQUESTS_PER_MINUTE) {
+    return false;
+  }
+  
+  recentRequests.push(now);
+  rateLimiter.set(clientId, recentRequests);
+  return true;
+}
+
+// Input validation
+function sanitizeInput(input) {
+  if (typeof input === 'string') {
+    return input.replace(/[<>]/g, '').trim().substring(0, 1000);
+  }
+  return input;
+}
+
+// Airtable API integration
+function callAirtableAPI(endpoint, method = 'GET', body = null, queryParams = {}) {
+  return new Promise((resolve, reject) => {
+    const isBaseEndpoint = !endpoint.startsWith('meta/');
+    const baseUrl = isBaseEndpoint ? `${baseId}/${endpoint}` : endpoint;
+    
+    const queryString = Object.keys(queryParams).length > 0 
+      ? '?' + new URLSearchParams(queryParams).toString() 
+      : '';
+    
+    const apiUrl = `https://api.airtable.com/v0/${baseUrl}${queryString}`;
+    const urlObj = new URL(apiUrl);
+    
+    log(LOG_LEVELS.DEBUG, 'API Request', { method, url: apiUrl });
+    
+    const options = {
+      hostname: urlObj.hostname,
+      path: urlObj.pathname + urlObj.search,
+      method: method,
+      headers: {
+        'Authorization': `Bearer ${token}`,
+        'Content-Type': 'application/json',
+        'User-Agent': 'Airtable-MCP-Server/2.1.0'
+      }
+    };
+    
+    const req = https.request(options, (response) => {
+      let data = '';
+      
+      response.on('data', (chunk) => data += chunk);
+      response.on('end', () => {
+        try {
+          const parsed = data ? JSON.parse(data) : {};
+          
+          if (response.statusCode >= 200 && response.statusCode < 300) {
+            resolve(parsed);
+          } else {
+            const error = parsed.error || {};
+            reject(new Error(`Airtable API error (${response.statusCode}): ${error.message || error.type || 'Unknown error'}`));
+          }
+        } catch (e) {
+          reject(new Error(`Failed to parse Airtable response: ${e.message}`));
+        }
+      });
+    });
+    
+    req.on('error', reject);
+    
+    if (body) {
+      req.write(JSON.stringify(body));
+    }
+    
+    req.end();
+  });
+}
+
+// Tools schema
+const TOOLS_SCHEMA = [
+  {
+    name: 'list_tables',
+    description: 'List all tables in the Airtable base',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        include_schema: { type: 'boolean', description: 'Include field schema information', default: false }
+      }
+    }
+  },
+  {
+    name: 'list_records',
+    description: 'List records from a specific table',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        table: { type: 'string', description: 'Table name or ID' },
+        maxRecords: { type: 'number', description: 'Maximum number of records to return' },
+        view: { type: 'string', description: 'View name or ID' },
+        filterByFormula: { type: 'string', description: 'Airtable formula to filter records' }
+      },
+      required: ['table']
+    }
+  },
+  {
+    name: 'get_record',
+    description: 'Get a single record by ID',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        table: { type: 'string', description: 'Table name or ID' },
+        recordId: { type: 'string', description: 'Record ID' }
+      },
+      required: ['table', 'recordId']
+    }
+  },
+  {
+    name: 'create_record',
+    description: 'Create a new record in a table',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        table: { type: 'string', description: 'Table name or ID' },
+        fields: { type: 'object', description: 'Field values for the new record' }
+      },
+      required: ['table', 'fields']
+    }
+  },
+  {
+    name: 'update_record',
+    description: 'Update an existing record',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        table: { type: 'string', description: 'Table name or ID' },
+        recordId: { type: 'string', description: 'Record ID to update' },
+        fields: { type: 'object', description: 'Fields to update' }
+      },
+      required: ['table', 'recordId', 'fields']
+    }
+  },
+  {
+    name: 'delete_record',
+    description: 'Delete a record from a table',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        table: { type: 'string', description: 'Table name or ID' },
+        recordId: { type: 'string', description: 'Record ID to delete' }
+      },
+      required: ['table', 'recordId']
+    }
+  }
+];
+
+// HTTP server
+const server = http.createServer(async (req, res) => {
+  // Security headers
+  res.setHeader('X-Content-Type-Options', 'nosniff');
+  res.setHeader('X-Frame-Options', 'DENY');
+  res.setHeader('X-XSS-Protection', '1; mode=block');
+  res.setHeader('Access-Control-Allow-Origin', process.env.ALLOWED_ORIGINS || '*');
+  res.setHeader('Access-Control-Allow-Methods', 'POST, GET, OPTIONS');
+  res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization');
+  
+  // Handle preflight request
+  if (req.method === 'OPTIONS') {
+    res.writeHead(200);
+    res.end();
+    return;
+  }
+  
+  const parsedUrl = url.parse(req.url, true);
+  const pathname = parsedUrl.pathname;
+  
+  // Health check endpoint
+  if (pathname === '/health' && req.method === 'GET') {
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({
+      status: 'healthy',
+      version: '2.1.0',
+      timestamp: new Date().toISOString(),
+      uptime: process.uptime()
+    }));
+    return;
+  }
+  
+  // MCP endpoint
+  if (pathname === '/mcp' && req.method === 'POST') {
+    // Rate limiting
+    const clientId = req.headers['x-client-id'] || req.connection.remoteAddress;
+    if (!checkRateLimit(clientId)) {
+      res.writeHead(429, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({
+        jsonrpc: '2.0',
+        error: {
+          code: -32000,
+          message: 'Rate limit exceeded. Maximum 60 requests per minute.'
+        }
+      }));
+      return;
+    }
+    
+    let body = '';
+    req.on('data', chunk => body += chunk.toString());
+    
+    req.on('end', async () => {
+      try {
+        const request = JSON.parse(body);
+        
+        // Sanitize inputs
+        if (request.params) {
+          Object.keys(request.params).forEach(key => {
+            request.params[key] = sanitizeInput(request.params[key]);
+          });
+        }
+        
+        log(LOG_LEVELS.DEBUG, 'MCP request received', { 
+          method: request.method, 
+          id: request.id 
+        });
+        
+        let response;
+        
+        switch (request.method) {
+          case 'initialize':
+            response = {
+              jsonrpc: '2.0',
+              id: request.id,
+              result: {
+                protocolVersion: '2024-11-05',
+                capabilities: {
+                  tools: { listChanged: true },
+                  resources: { subscribe: true, listChanged: true },
+                  prompts: { listChanged: true },
+                  sampling: {},
+                  roots: { listChanged: true },
+                  logging: {}
+                },
+                serverInfo: {
+                  name: 'Airtable MCP Server',
+                  version: '2.1.0',
+                  description: 'Model Context Protocol server for Airtable integration'
+                }
+              }
+            };
+            log(LOG_LEVELS.INFO, 'Client initialized', { clientId: request.id });
+            break;
+            
+          case 'tools/list':
+            response = {
+              jsonrpc: '2.0',
+              id: request.id,
+              result: {
+                tools: TOOLS_SCHEMA
+              }
+            };
+            break;
+            
+          case 'tools/call':
+            response = await handleToolCall(request);
+            break;
+            
+          default:
+            log(LOG_LEVELS.WARN, 'Unknown method', { method: request.method });
+            throw new Error(`Method "${request.method}" not found`);
+        }
+        
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify(response));
+        
+      } catch (error) {
+        log(LOG_LEVELS.ERROR, 'Request processing failed', { error: error.message });
+        
+        const errorResponse = {
+          jsonrpc: '2.0',
+          id: request?.id || null,
+          error: {
+            code: -32000,
+            message: error.message || 'Internal server error'
+          }
+        };
+        
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify(errorResponse));
+      }
+    });
+    return;
+  }
+  
+  // Default 404
+  res.writeHead(404, { 'Content-Type': 'application/json' });
+  res.end(JSON.stringify({ error: 'Not Found' }));
+});
+
+// Tool handlers
+async function handleToolCall(request) {
+  const toolName = request.params.name;
+  const toolParams = request.params.arguments || {};
+  
+  try {
+    let result;
+    let responseText;
+    
+    switch (toolName) {
+      case 'list_tables':
+        const includeSchema = toolParams.include_schema || false;
+        result = await callAirtableAPI(`meta/bases/${baseId}/tables`);
+        const tables = result.tables || [];
+        
+        responseText = tables.length > 0 
+          ? `Found ${tables.length} table(s): ` + 
+            tables.map((table, i) => 
+              `${table.name} (ID: ${table.id}, Fields: ${table.fields?.length || 0})`
+            ).join(', ')
+          : 'No tables found in this base.';
+        break;
+        
+      case 'list_records':
+        const { table, maxRecords, view, filterByFormula } = toolParams;
+        
+        const queryParams = {};
+        if (maxRecords) queryParams.maxRecords = maxRecords;
+        if (view) queryParams.view = view;
+        if (filterByFormula) queryParams.filterByFormula = filterByFormula;
+        
+        result = await callAirtableAPI(table, 'GET', null, queryParams);
+        const records = result.records || [];
+        
+        responseText = records.length > 0
+          ? `Found ${records.length} record(s) in table "${table}"`
+          : `No records found in table "${table}".`;
+        break;
+        
+      case 'get_record':
+        const { table: getTable, recordId } = toolParams;
+        result = await callAirtableAPI(`${getTable}/${recordId}`);
+        responseText = `Retrieved record ${recordId} from table "${getTable}"`;
+        break;
+        
+      case 'create_record':
+        const { table: createTable, fields } = toolParams;
+        const body = { fields: fields };
+        result = await callAirtableAPI(createTable, 'POST', body);
+        responseText = `Successfully created record in table "${createTable}" with ID: ${result.id}`;
+        break;
+        
+      case 'update_record':
+        const { table: updateTable, recordId: updateRecordId, fields: updateFields } = toolParams;
+        const updateBody = { fields: updateFields };
+        result = await callAirtableAPI(`${updateTable}/${updateRecordId}`, 'PATCH', updateBody);
+        responseText = `Successfully updated record ${updateRecordId} in table "${updateTable}"`;
+        break;
+        
+      case 'delete_record':
+        const { table: deleteTable, recordId: deleteRecordId } = toolParams;
+        result = await callAirtableAPI(`${deleteTable}/${deleteRecordId}`, 'DELETE');
+        responseText = `Successfully deleted record ${deleteRecordId} from table "${deleteTable}"`;
+        break;
+        
+      default:
+        throw new Error(`Unknown tool: ${toolName}`);
+    }
+    
+    return {
+      jsonrpc: '2.0',
+      id: request.id,
+      result: {
+        content: [
+          {
+            type: 'text',
+            text: responseText
+          }
+        ]
+      }
+    };
+    
+  } catch (error) {
+    log(LOG_LEVELS.ERROR, `Tool ${toolName} failed`, { error: error.message });
+    
+    return {
+      jsonrpc: '2.0',
+      id: request.id,
+      result: {
+        content: [
+          {
+            type: 'text',
+            text: `Error executing ${toolName}: ${error.message}`
+          }
+        ]
+      }
+    };
+  }
+}
+
+// Server startup
+const PORT = CONFIG.PORT;
+const HOST = CONFIG.HOST;
+
+server.listen(PORT, HOST, () => {
+  log(LOG_LEVELS.INFO, `Airtable MCP Server started`, {
+    host: HOST,
+    port: PORT,
+    version: '2.1.0'
+  });
+  
+  console.log(`
+╔═══════════════════════════════════════════════════════════════╗
+║                 Airtable MCP Server v2.1                     ║
+║            Model Context Protocol Implementation              ║
+╠═══════════════════════════════════════════════════════════════╣
+║  🌐 MCP Endpoint: http://${HOST}:${PORT}/mcp                  ║
+║  📊 Health Check: http://${HOST}:${PORT}/health               ║
+║  🔒 Security: Rate limiting, input validation                ║
+║  📋 Tools: ${TOOLS_SCHEMA.length} available operations                    ║
+╠═══════════════════════════════════════════════════════════════╣
+║  🔗 Connected to Airtable Base: ${baseId.slice(0, 8)}...        ║
+║  🚀 Ready for MCP client connections                         ║
+╚═══════════════════════════════════════════════════════════════╝
+  `);
+});
+
+// Graceful shutdown
+function gracefulShutdown(signal) {
+  log(LOG_LEVELS.INFO, 'Graceful shutdown initiated', { signal });
+  
+  server.close(() => {
+    log(LOG_LEVELS.INFO, 'Server stopped');
+    process.exit(0);
+  });
+  
+  setTimeout(() => {
+    log(LOG_LEVELS.ERROR, 'Force shutdown - server did not close in time');
+    process.exit(1);
+  }, 10000);
+}
+
+process.on('SIGTERM', () => gracefulShutdown('SIGTERM'));
+process.on('SIGINT', () => gracefulShutdown('SIGINT'));
+
+process.on('uncaughtException', (error) => {
+  log(LOG_LEVELS.ERROR, 'Uncaught exception', { error: error.message });
+  gracefulShutdown('uncaughtException');
+});
+
+process.on('unhandledRejection', (reason) => {
+  log(LOG_LEVELS.ERROR, 'Unhandled promise rejection', { reason: reason?.toString() });
+  gracefulShutdown('unhandledRejection');
+});

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.1",
+  "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",
@@ -22,6 +22,15 @@
     "ai",
     "database"
   ],
+  "files": [
+    "airtable_simple.js",
+    "airtable_simple_production.js",
+    "README.md",
+    "LICENSE",
+    "package.json",
+    "examples/",
+    "bin/"
+  ],
   "author": "Rashid Azarang",
   "license": "MIT",
   "dependencies": {

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": []
-  }
-}

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,38 +0,0 @@
----
-name: Bug report
-about: Create a report to help us improve
-title: ''
-labels: ''
-assignees: ''
-
----
-
-**Describe the bug**
-A clear and concise description of what the bug is.
-
-**To Reproduce**
-Steps to reproduce the behavior:
-1. Go to '...'
-2. Click on '....'
-3. Scroll down to '....'
-4. See error
-
-**Expected behavior**
-A clear and concise description of what you expected to happen.
-
-**Screenshots**
-If applicable, add screenshots to help explain your problem.
-
-**Desktop (please complete the following information):**
- - OS: [e.g. iOS]
- - Browser [e.g. chrome, safari]
- - Version [e.g. 22]
-
-**Smartphone (please complete the following information):**
- - Device: [e.g. iPhone6]
- - OS: [e.g. iOS8.1]
- - Browser [e.g. stock browser, safari]
- - Version [e.g. 22]
-
-**Additional context**
-Add any other context about the problem here.

package/.github/ISSUE_TEMPLATE/custom.md

@@ -1,10 +0,0 @@
----
-name: Custom issue template
-about: Describe this issue template's purpose here.
-title: ''
-labels: ''
-assignees: ''
-
----
-
-

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,20 +0,0 @@
----
-name: Feature request
-about: Suggest an idea for this project
-title: ''
-labels: ''
-assignees: ''
-
----
-
-**Is your feature request related to a problem? Please describe.**
-A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
-
-**Describe the solution you'd like**
-A clear and concise description of what you want to happen.
-
-**Describe alternatives you've considered**
-A clear and concise description of any alternative solutions or features you've considered.
-
-**Additional context**
-Add any other context or screenshots about the feature request here.