@rashidazarang/airtable-mcp 2.1.0 → 2.2.0

package/simple_airtable_server.py

@@ -1,151 +0,0 @@
-#!/usr/bin/env python3
-"""
-Simple Airtable MCP Server for Claude
--------------------------------------
-A minimal MCP server that implements Airtable tools and Claude's special methods
-"""
-import os
-import sys
-import json
-import logging
-import requests
-import traceback
-from typing import Dict, Any, List, Optional
-
-# Check if MCP SDK is installed
-try:
-    from mcp.server.fastmcp import FastMCP
-except ImportError:
-    print("Error: MCP SDK not found. Please install with 'pip install mcp'")
-    sys.exit(1)
-
-# Parse command line arguments
-if len(sys.argv) < 5:
-    print("Usage: python3 simple_airtable_server.py --token YOUR_TOKEN --base YOUR_BASE_ID")
-    sys.exit(1)
-
-# Get the token and base ID from command line arguments
-token = None
-base_id = None
-for i in range(1, len(sys.argv)):
-    if sys.argv[i] == "--token" and i+1 < len(sys.argv):
-        token = sys.argv[i+1]
-    elif sys.argv[i] == "--base" and i+1 < len(sys.argv):
-        base_id = sys.argv[i+1]
-
-if not token:
-    print("Error: No Airtable token provided. Use --token parameter.")
-    sys.exit(1)
-
-if not base_id:
-    print("Error: No base ID provided. Use --base parameter.")
-    sys.exit(1)
-
-# Set up logging
-logging.basicConfig(level=logging.INFO)
-logger = logging.getLogger("airtable-mcp")
-
-# Create MCP server
-app = FastMCP("Airtable Tools")
-
-# Helper function for Airtable API calls
-async def airtable_api_call(endpoint, method="GET", data=None, params=None):
-    """Make an Airtable API call with error handling"""
-    headers = {
-        "Authorization": f"Bearer {token}",
-        "Content-Type": "application/json"
-    }
-    
-    url = f"https://api.airtable.com/v0/{endpoint}"
-    
-    try:
-        if method == "GET":
-            response = requests.get(url, headers=headers, params=params)
-        elif method == "POST":
-            response = requests.post(url, headers=headers, json=data)
-        else:
-            raise ValueError(f"Unsupported method: {method}")
-        
-        response.raise_for_status()
-        return response.json()
-    except Exception as e:
-        logger.error(f"API call error: {str(e)}")
-        return {"error": str(e)}
-
-# Claude-specific methods
-@app.rpc_method("resources/list")
-async def resources_list(params: Dict = None) -> Dict:
-    """List available Airtable resources for Claude"""
-    try:
-        # Return a simple list of resources
-        resources = [
-            {"id": "airtable_tables", "name": "Airtable Tables", "description": "Tables in your Airtable base"}
-        ]
-        return {"resources": resources}
-    except Exception as e:
-        logger.error(f"Error in resources/list: {str(e)}")
-        return {"error": {"code": -32000, "message": str(e)}}
-
-@app.rpc_method("prompts/list")
-async def prompts_list(params: Dict = None) -> Dict:
-    """List available prompts for Claude"""
-    try:
-        # Return a simple list of prompts
-        prompts = [
-            {"id": "tables_prompt", "name": "List Tables", "description": "List all tables"}
-        ]
-        return {"prompts": prompts}
-    except Exception as e:
-        logger.error(f"Error in prompts/list: {str(e)}")
-        return {"error": {"code": -32000, "message": str(e)}}
-
-# Airtable tool functions
-@app.tool()
-async def list_tables() -> str:
-    """List all tables in the specified base"""
-    try:
-        result = await airtable_api_call(f"meta/bases/{base_id}/tables")
-        
-        if "error" in result:
-            return f"Error: {result['error']}"
-        
-        tables = result.get("tables", [])
-        if not tables:
-            return "No tables found in this base."
-        
-        table_list = [f"{i+1}. {table['name']} (ID: {table['id']})" 
-                    for i, table in enumerate(tables)]
-        return "Tables in this base:\n" + "\n".join(table_list)
-    except Exception as e:
-        return f"Error listing tables: {str(e)}"
-
-@app.tool()
-async def list_records(table_name: str, max_records: int = 100) -> str:
-    """List records from a table"""
-    try:
-        params = {"maxRecords": max_records}
-        result = await airtable_api_call(f"{base_id}/{table_name}", params=params)
-        
-        if "error" in result:
-            return f"Error: {result['error']}"
-        
-        records = result.get("records", [])
-        if not records:
-            return "No records found in this table."
-        
-        # Format the records for display
-        formatted_records = []
-        for i, record in enumerate(records):
-            record_id = record.get("id", "unknown")
-            fields = record.get("fields", {})
-            field_text = ", ".join([f"{k}: {v}" for k, v in fields.items()])
-            formatted_records.append(f"{i+1}. ID: {record_id} - {field_text}")
-        
-        return "Records:\n" + "\n".join(formatted_records)
-    except Exception as e:
-        return f"Error listing records: {str(e)}"
-
-# Start the server
-if __name__ == "__main__":
-    print(f"Starting Airtable MCP Server with token {token[:5]}...{token[-5:]} and base {base_id}")
-    app.start() 

package/smithery.yaml

@@ -1,45 +0,0 @@
-# Smithery.ai configuration
-name: "@rashidazarang/airtable-mcp"
-version: "1.2.4"
-description: "Connect your AI tools directly to Airtable. Query, create, update, and delete records using natural language. Features include base management, table operations, schema manipulation, record filtering, and data migration—all through a standardized MCP interface compatible with Claude Desktop and other Claude-powered editors."
-
-startCommand:
-  type: stdio
-  configSchema:
-    type: object
-    properties:
-      airtable_token:
-        type: string
-        description: "Your Airtable Personal Access Token"
-        required: true
-      base_id:
-        type: string
-        description: "Your default Airtable base ID"
-        required: true
-    required: ["airtable_token", "base_id"]
-  commandFunction: |
-    (config) => {
-      // Use the working JavaScript implementation
-      return {
-        command: "node",
-        args: ["airtable_simple.js", "--token", config.airtable_token, "--base", config.base_id],
-        env: {
-          AIRTABLE_TOKEN: config.airtable_token,
-          AIRTABLE_BASE_ID: config.base_id
-        }
-      };
-    }
-
-listTools:
-  command: "node"
-  args: ["airtable_simple.js", "--list-tools"]
-  env: {}
-  
-build:
-  dockerfile: "Dockerfile.node"
-
-metadata:
-  author: "Rashid Azarang"
-  license: "MIT"
-  repository: "https://github.com/rashidazarang/airtable-mcp"
-  homepage: "https://github.com/rashidazarang/airtable-mcp#readme"

package/test_all_features.sh

@@ -1,146 +0,0 @@
-#!/bin/bash
-
-echo "🎯 COMPREHENSIVE TEST - AIRTABLE MCP v1.4.0"
-echo "==========================================="
-echo ""
-
-PASSED=0
-FAILED=0
-TOTAL=0
-
-# Test function
-test_feature() {
-    local name=$1
-    local result=$2
-    ((TOTAL++))
-    
-    if [ "$result" = "PASS" ]; then
-        echo "✅ $name"
-        ((PASSED++))
-    else
-        echo "❌ $name"
-        ((FAILED++))
-    fi
-}
-
-echo "📊 TESTING ALL 12 TOOLS"
-echo "======================="
-echo ""
-
-# 1. List tables
-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_tables"}}')
-if [[ "$result" == *"table"* ]]; then
-    test_feature "list_tables" "PASS"
-else
-    test_feature "list_tables" "FAIL"
-fi
-
-# 2. Create record
-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_record", "arguments": {"table": "tblH7TnJxYpNqhQYK", "fields": {"Name": "Final Test", "Status": "Active"}}}}')
-if [[ "$result" == *"Successfully created"* ]]; then
-    test_feature "create_record" "PASS"
-    RECORD_ID=$(echo "$result" | grep -o 'rec[a-zA-Z0-9]\{10,20\}' | head -1)
-else
-    test_feature "create_record" "FAIL"
-    RECORD_ID=""
-fi
-
-# 3. Get record
-if [ ! -z "$RECORD_ID" ]; then
-    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\": \"get_record\", \"arguments\": {\"table\": \"tblH7TnJxYpNqhQYK\", \"recordId\": \"$RECORD_ID\"}}}")
-    [[ "$result" == *"Record $RECORD_ID"* ]] && test_feature "get_record" "PASS" || test_feature "get_record" "FAIL"
-else
-    test_feature "get_record" "SKIP"
-fi
-
-# 4. Update record
-if [ ! -z "$RECORD_ID" ]; then
-    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\": \"update_record\", \"arguments\": {\"table\": \"tblH7TnJxYpNqhQYK\", \"recordId\": \"$RECORD_ID\", \"fields\": {\"Status\": \"Completed\"}}}}")
-    [[ "$result" == *"Successfully updated"* ]] && test_feature "update_record" "PASS" || test_feature "update_record" "FAIL"
-else
-    test_feature "update_record" "SKIP"
-fi
-
-# 5. List records
-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": "list_records", "arguments": {"table": "tblH7TnJxYpNqhQYK", "maxRecords": 3}}}')
-[[ "$result" == *"record"* ]] && test_feature "list_records" "PASS" || test_feature "list_records" "FAIL"
-
-# 6. Search records
-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": "search_records", "arguments": {"table": "tblH7TnJxYpNqhQYK", "maxRecords": 3}}}')
-[[ "$result" == *"record"* ]] && test_feature "search_records" "PASS" || test_feature "search_records" "FAIL"
-
-# 7. Delete record
-if [ ! -z "$RECORD_ID" ]; then
-    result=$(curl -s -X POST http://localhost:8010/mcp -H "Content-Type: application/json" \
-        -d "{\"jsonrpc\": \"2.0\", \"id\": 7, \"method\": \"tools/call\", \"params\": {\"name\": \"delete_record\", \"arguments\": {\"table\": \"tblH7TnJxYpNqhQYK\", \"recordId\": \"$RECORD_ID\"}}}")
-    [[ "$result" == *"Successfully deleted"* ]] && test_feature "delete_record" "PASS" || test_feature "delete_record" "FAIL"
-else
-    test_feature "delete_record" "SKIP"
-fi
-
-# 8. List webhooks
-result=$(curl -s -X POST http://localhost:8010/mcp -H "Content-Type: application/json" \
-    -d '{"jsonrpc": "2.0", "id": 8, "method": "tools/call", "params": {"name": "list_webhooks"}}')
-[[ "$result" == *"webhook"* ]] && test_feature "list_webhooks" "PASS" || test_feature "list_webhooks" "FAIL"
-
-# 9. Create webhook
-result=$(curl -s -X POST http://localhost:8010/mcp -H "Content-Type: application/json" \
-    -d '{"jsonrpc": "2.0", "id": 9, "method": "tools/call", "params": {"name": "create_webhook", "arguments": {"notificationUrl": "https://webhook.site/test-final"}}}')
-if [[ "$result" == *"Successfully created"* ]]; then
-    test_feature "create_webhook" "PASS"
-    WEBHOOK_ID=$(echo "$result" | grep -o 'ach[a-zA-Z0-9]*' | head -1)
-else
-    test_feature "create_webhook" "FAIL"
-    WEBHOOK_ID=""
-fi
-
-# 10. Get webhook payloads
-if [ ! -z "$WEBHOOK_ID" ]; then
-    result=$(curl -s -X POST http://localhost:8010/mcp -H "Content-Type: application/json" \
-        -d "{\"jsonrpc\": \"2.0\", \"id\": 10, \"method\": \"tools/call\", \"params\": {\"name\": \"get_webhook_payloads\", \"arguments\": {\"webhookId\": \"$WEBHOOK_ID\"}}}")
-    [[ "$result" == *"payload"* ]] && test_feature "get_webhook_payloads" "PASS" || test_feature "get_webhook_payloads" "FAIL"
-else
-    test_feature "get_webhook_payloads" "SKIP"
-fi
-
-# 11. Refresh webhook
-if [ ! -z "$WEBHOOK_ID" ]; then
-    result=$(curl -s -X POST http://localhost:8010/mcp -H "Content-Type: application/json" \
-        -d "{\"jsonrpc\": \"2.0\", \"id\": 11, \"method\": \"tools/call\", \"params\": {\"name\": \"refresh_webhook\", \"arguments\": {\"webhookId\": \"$WEBHOOK_ID\"}}}")
-    [[ "$result" == *"refreshed"* ]] && test_feature "refresh_webhook" "PASS" || test_feature "refresh_webhook" "FAIL"
-else
-    test_feature "refresh_webhook" "SKIP"
-fi
-
-# 12. Delete webhook
-if [ ! -z "$WEBHOOK_ID" ]; then
-    result=$(curl -s -X POST http://localhost:8010/mcp -H "Content-Type: application/json" \
-        -d "{\"jsonrpc\": \"2.0\", \"id\": 12, \"method\": \"tools/call\", \"params\": {\"name\": \"delete_webhook\", \"arguments\": {\"webhookId\": \"$WEBHOOK_ID\"}}}")
-    [[ "$result" == *"deleted"* ]] && test_feature "delete_webhook" "PASS" || test_feature "delete_webhook" "FAIL"
-else
-    test_feature "delete_webhook" "SKIP"
-fi
-
-echo ""
-echo "📈 FINAL RESULTS"
-echo "==============="
-echo "Total Tests: $TOTAL"
-echo "✅ Passed: $PASSED"
-echo "❌ Failed: $FAILED"
-echo "Success Rate: $(( PASSED * 100 / TOTAL ))%"
-
-if [ $FAILED -eq 0 ]; then
-    echo ""
-    echo "🎉 ALL TESTS PASSED! v1.4.0 is ready for production!"
-    exit 0
-else
-    echo ""
-    echo "⚠️  $FAILED test(s) failed. Please review."
-    exit 1
-fi

package/test_all_operations.sh

@@ -1,120 +0,0 @@
-#!/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

@@ -1,70 +0,0 @@
-#!/usr/bin/env python3
-"""
-Simple test client for Airtable MCP
-"""
-import asyncio
-import json
-import os
-import sys
-import subprocess
-import time
-from typing import Dict, Any
-
-# 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):
-    """Make a direct Airtable API call to test API access"""
-    import requests
-    headers = {
-        "Authorization": f"Bearer {token}",
-        "Content-Type": "application/json"
-    }
-    url = f"https://api.airtable.com/v0/{endpoint}"
-    
-    try:
-        response = requests.get(url, headers=headers)
-        response.raise_for_status()
-        return response.json()
-    except Exception as e:
-        print(f"API error: {str(e)}")
-        return {"error": str(e)}
-
-async def main():
-    # Instead of using the MCP, let's directly test the Airtable API
-    print("Testing direct API access...")
-    
-    # List bases
-    print("\nListing bases:")
-    result = api_call("meta/bases")
-    if "error" in result:
-        print(f"Error: {result['error']}")
-    else:
-        bases = result.get("bases", [])
-        for i, base in enumerate(bases):
-            print(f"{i+1}. {base['name']} (ID: {base['id']})")
-    
-    # List tables in the specified base
-    print(f"\nListing tables in base {BASE_ID}:")
-    result = api_call(f"meta/bases/{BASE_ID}/tables")
-    if "error" in result:
-        print(f"Error: {result['error']}")
-    else:
-        tables = result.get("tables", [])
-        for i, table in enumerate(tables):
-            print(f"{i+1}. {table['name']} (ID: {table['id']}, Fields: {len(table.get('fields', []))})")
-            # Print fields
-            print("   Fields:")
-            for field in table.get('fields', []):
-                print(f"   - {field['name']} ({field['type']})")
-
-if __name__ == "__main__":
-    asyncio.run(main())