@rashidazarang/airtable-mcp 2.1.0 → 2.2.0

package/Dockerfile.node

@@ -1,20 +0,0 @@
-FROM node:18-slim
-
-WORKDIR /app
-
-# Copy package files
-COPY package*.json ./
-
-# Install dependencies
-RUN npm ci --only=production
-
-# Copy the main application files
-COPY airtable_simple.js ./
-COPY .env.example ./
-
-# Create a non-root user
-RUN useradd -m -u 1000 mcpuser && chown -R mcpuser:mcpuser /app
-USER mcpuser
-
-# The server will be started with command line arguments by Smithery
-ENTRYPOINT ["node", "airtable_simple.js"]

package/Dockerfile.production

@@ -1,127 +0,0 @@
-# Multi-stage Production Dockerfile for Airtable MCP Server
-# Optimized for security, performance, and minimal attack surface
-# Trust Score: 100/100 target
-
-# ============================================================================
-# BUILD STAGE - Dependencies and compilation
-# ============================================================================
-FROM node:18-alpine AS builder
-
-# Security: Create non-root user early
-RUN addgroup -g 1001 -S nodejs && \
-    adduser -S mcp -u 1001
-
-# Set working directory
-WORKDIR /app
-
-# Copy package files for dependency installation
-COPY package*.json ./
-COPY .npmrc* ./
-
-# Install dependencies with security optimizations
-RUN npm ci --only=production --ignore-scripts && \
-    npm cache clean --force && \
-    # Remove npm to reduce attack surface
-    rm -rf /usr/local/lib/node_modules/npm
-
-# Copy application source
-COPY --chown=mcp:nodejs . .
-
-# Remove development files and sensitive data
-RUN rm -rf \
-    .git \
-    .github \
-    tests \
-    *.test.js \
-    *.spec.js \
-    .env.example \
-    .env.* \
-    docs \
-    examples/python* \
-    *.md \
-    .eslintrc* \
-    .prettier* \
-    jest.config* \
-    coverage
-
-# ============================================================================
-# RUNTIME STAGE - Minimal production image
-# ============================================================================
-FROM node:18-alpine AS production
-
-# Security labels and metadata
-LABEL maintainer="Rashid Azarang <rashid@example.com>" \
-      description="Enhanced Airtable MCP Server v2.1 - Production Ready" \
-      version="2.1.0" \
-      security.scan="enabled" \
-      trust.score="100" \
-      org.opencontainers.image.title="Airtable MCP Server" \
-      org.opencontainers.image.description="Production-ready MCP server with OAuth2 and enterprise security" \
-      org.opencontainers.image.version="2.1.0" \
-      org.opencontainers.image.vendor="Rashid Azarang" \
-      org.opencontainers.image.licenses="MIT" \
-      org.opencontainers.image.source="https://github.com/rashidazarang/airtable-mcp"
-
-# Install security updates and minimal runtime dependencies
-RUN apk update && \
-    apk upgrade && \
-    apk add --no-cache \
-    ca-certificates \
-    curl \
-    dumb-init \
-    tzdata && \
-    # Clean up
-    rm -rf /var/cache/apk/* /tmp/*
-
-# Create non-root user and group
-RUN addgroup -g 1001 -S nodejs && \
-    adduser -S mcp -u 1001 -G nodejs
-
-# Set working directory
-WORKDIR /app
-
-# Copy built application from builder stage
-COPY --from=builder --chown=mcp:nodejs /app/node_modules ./node_modules
-COPY --from=builder --chown=mcp:nodejs /app/package*.json ./
-COPY --from=builder --chown=mcp:nodejs /app/*.js ./
-
-# Create necessary directories with proper permissions
-RUN mkdir -p /app/logs /app/tmp && \
-    chown -R mcp:nodejs /app && \
-    chmod -R 750 /app && \
-    chmod -R 755 /app/logs /app/tmp
-
-# Security: Remove shell access and package managers
-RUN rm -rf /bin/sh /usr/bin/wget /usr/bin/curl || true
-
-# Switch to non-root user
-USER mcp:nodejs
-
-# Health check
-HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
-    CMD node -e "require('http').get('http://localhost:8010/health', (res) => { process.exit(res.statusCode === 200 ? 0 : 1) })"
-
-# Environment variables with secure defaults
-ENV NODE_ENV=production \
-    PORT=8010 \
-    HOST=0.0.0.0 \
-    LOG_LEVEL=INFO \
-    LOG_FORMAT=json \
-    CACHE_TTL=60 \
-    MAX_REQUESTS_PER_MINUTE=60 \
-    CONNECTION_TIMEOUT=30000 \
-    REQUEST_TIMEOUT=10000
-
-# Expose port
-EXPOSE 8010
-
-# Use dumb-init for proper signal handling
-ENTRYPOINT ["/usr/bin/dumb-init", "--"]
-
-# Start the application
-CMD ["node", "airtable_mcp_v2_oauth.js"]
-
-# Security: Set read-only filesystem (uncomment for maximum security)
-# Note: May require volume mounts for logs and tmp directories
-# RUN chmod -R a-w /app
-# VOLUME ["/app/logs", "/app/tmp"]

package/IMPROVEMENT_PROPOSAL.md

@@ -1,371 +0,0 @@
-# Airtable MCP Improvement Proposal
-
-## Current State Analysis
-
-### Existing Tools (v1.2.4)
-1. **list_tables** - Lists all tables in a base
-2. **list_records** - Lists records from a specific table
-
-### Missing Core CRUD Operations
-The MCP currently only supports READ operations. We need full CRUD capabilities.
-
-## Proposed New Features
-
-### 🔥 Priority 1: Complete CRUD Operations
-
-#### 1. **create_record**
-Create new records in any table
-```javascript
-{
-  name: "create_record",
-  params: {
-    table: "string",
-    fields: "object"
-  }
-}
-```
-
-#### 2. **update_record**
-Update existing records
-```javascript
-{
-  name: "update_record",
-  params: {
-    table: "string",
-    recordId: "string",
-    fields: "object"
-  }
-}
-```
-
-#### 3. **delete_record**
-Delete records from tables
-```javascript
-{
-  name: "delete_record",
-  params: {
-    table: "string",
-    recordId: "string"
-  }
-}
-```
-
-#### 4. **batch_operations**
-Perform bulk create/update/delete (up to 10 records)
-```javascript
-{
-  name: "batch_operations",
-  params: {
-    table: "string",
-    operation: "create|update|delete",
-    records: "array"
-  }
-}
-```
-
-### 🚀 Priority 2: Advanced Query & Filter
-
-#### 5. **search_records**
-Search with complex filters and sorting
-```javascript
-{
-  name: "search_records",
-  params: {
-    table: "string",
-    filterByFormula: "string",  // Airtable formula syntax
-    sort: [{field: "string", direction: "asc|desc"}],
-    maxRecords: "number",
-    fields: ["string"]  // Specific fields to return
-  }
-}
-```
-
-#### 6. **get_record_by_id**
-Get a single record by its ID
-```javascript
-{
-  name: "get_record_by_id",
-  params: {
-    table: "string",
-    recordId: "string"
-  }
-}
-```
-
-### 📊 Priority 3: Schema Management
-
-#### 7. **get_table_schema**
-Get detailed field information for a table
-```javascript
-{
-  name: "get_table_schema",
-  params: {
-    table: "string"
-  }
-}
-```
-
-#### 8. **create_table**
-Create a new table in the base
-```javascript
-{
-  name: "create_table",
-  params: {
-    name: "string",
-    fields: [{name: "string", type: "string", options: "object"}]
-  }
-}
-```
-
-#### 9. **create_field**
-Add a new field to an existing table
-```javascript
-{
-  name: "create_field",
-  params: {
-    table: "string",
-    field: {name: "string", type: "string", options: "object"}
-  }
-}
-```
-
-### 🔄 Priority 4: Data Management
-
-#### 10. **export_table**
-Export entire table as JSON/CSV
-```javascript
-{
-  name: "export_table",
-  params: {
-    table: "string",
-    format: "json|csv"
-  }
-}
-```
-
-#### 11. **import_data**
-Import data from JSON/CSV
-```javascript
-{
-  name: "import_data",
-  params: {
-    table: "string",
-    data: "string|array",
-    format: "json|csv",
-    updateExisting: "boolean"
-  }
-}
-```
-
-#### 12. **duplicate_table**
-Clone a table with or without data
-```javascript
-{
-  name: "duplicate_table",
-  params: {
-    sourceTable: "string",
-    newName: "string",
-    includeData: "boolean"
-  }
-}
-```
-
-### 🔗 Priority 5: Relationships & Links
-
-#### 13. **link_records**
-Create links between records in linked fields
-```javascript
-{
-  name: "link_records",
-  params: {
-    sourceTable: "string",
-    sourceRecordId: "string",
-    linkField: "string",
-    targetRecordIds: ["string"]
-  }
-}
-```
-
-#### 14. **get_linked_records**
-Fetch all records linked from a specific record
-```javascript
-{
-  name: "get_linked_records",
-  params: {
-    table: "string",
-    recordId: "string",
-    linkField: "string"
-  }
-}
-```
-
-### 📈 Priority 6: Analytics & Aggregation
-
-#### 15. **aggregate_data**
-Perform aggregations on table data
-```javascript
-{
-  name: "aggregate_data",
-  params: {
-    table: "string",
-    aggregations: [{
-      field: "string",
-      function: "sum|avg|count|min|max"
-    }],
-    groupBy: ["string"]
-  }
-}
-```
-
-#### 16. **get_table_stats**
-Get statistics about a table
-```javascript
-{
-  name: "get_table_stats",
-  params: {
-    table: "string"
-  }
-  // Returns: record count, field types, storage size, etc.
-}
-```
-
-### 🔍 Priority 7: Views Management
-
-#### 17. **list_views**
-List all views in a table
-```javascript
-{
-  name: "list_views",
-  params: {
-    table: "string"
-  }
-}
-```
-
-#### 18. **get_view_records**
-Get records from a specific view
-```javascript
-{
-  name: "get_view_records",
-  params: {
-    table: "string",
-    view: "string"
-  }
-}
-```
-
-### 🎨 Priority 8: Attachments & Media
-
-#### 19. **upload_attachment**
-Upload files to attachment fields
-```javascript
-{
-  name: "upload_attachment",
-  params: {
-    table: "string",
-    recordId: "string",
-    field: "string",
-    fileUrl: "string|base64"
-  }
-}
-```
-
-#### 20. **get_attachments**
-Download attachments from records
-```javascript
-{
-  name: "get_attachments",
-  params: {
-    table: "string",
-    recordId: "string",
-    field: "string"
-  }
-}
-```
-
-## Implementation Roadmap
-
-### Phase 1 (Version 1.3.0) - Essential CRUD
-- ✅ create_record
-- ✅ update_record
-- ✅ delete_record
-- ✅ get_record_by_id
-- ✅ search_records
-
-### Phase 2 (Version 1.4.0) - Batch & Schema
-- batch_operations
-- get_table_schema
-- export_table
-- import_data
-
-### Phase 3 (Version 1.5.0) - Advanced Features
-- create_table
-- create_field
-- link_records
-- get_linked_records
-
-### Phase 4 (Version 2.0.0) - Enterprise Features
-- aggregate_data
-- Views management
-- Attachments handling
-- Webhooks support
-
-## Technical Considerations
-
-### Rate Limiting
-- Implement request queuing to respect 5 req/sec limit
-- Add retry logic with exponential backoff
-- Cache frequently accessed data
-
-### Error Handling
-- Detailed error messages for debugging
-- Graceful fallbacks for missing permissions
-- Validation of input parameters
-
-### Performance
-- Implement pagination for large datasets
-- Add optional field filtering to reduce payload
-- Support streaming for large exports
-
-### Security
-- Validate all input to prevent injection
-- Support field-level permissions
-- Add optional audit logging
-
-## Usage Examples
-
-### Creating a Record
-```
-"Create a new task in the Tasks table with title 'Review proposal' and status 'In Progress'"
-```
-
-### Complex Search
-```
-"Find all high-priority tasks assigned to John that are due this week"
-```
-
-### Bulk Operations
-```
-"Mark all tasks with status 'Done' as archived"
-```
-
-### Data Export
-```
-"Export the entire Customers table as a CSV file"
-```
-
-## Benefits
-
-1. **Complete Functionality**: Full CRUD operations matching Airtable's capabilities
-2. **Natural Language**: All operations accessible through conversational AI
-3. **Productivity**: Batch operations and data import/export save time
-4. **Flexibility**: Support for complex queries and relationships
-5. **Enterprise Ready**: Schema management and analytics features
-
-## Next Steps
-
-1. Prioritize features based on user needs
-2. Implement Phase 1 features (essential CRUD)
-3. Add comprehensive testing for each new tool
-4. Update documentation with examples
-5. Gather user feedback for Phase 2 planning

package/INSTALLATION.md

@@ -1,183 +0,0 @@
-# Installation
-
-Airtable MCP embeds Airtable database connectivity directly into your AI-powered code editor
-
-## Getting Started
-
-Built by Rashid Azarang,
-
-Airtable MCP gives AI code editors and agents the ability to access and manipulate your Airtable databases for powerful data management capabilities - all in a secure manner with your own API tokens.
-
-With this MCP server tool, you can enable AI code editors and agents to have access to:
-
-* List and access all your Airtable bases
-* Browse tables, fields, and record data
-* Create, read, update, and delete records
-* Export and manipulate schemas
-* Perform complex queries against your data
-* Create data migration mappings
-* Analyze and transform your Airtable data
-
-That way, you can simply tell Cursor or any AI code editor with MCP integrations:
-
-"Show me all the tables in my Airtable base"
-
-"Find all records from the Customers table where the status is Active and the last purchase was after January 1st"
-
-"Create a new record in the Products table with these fields..."
-
-"Export the schema of my current Airtable base"
-
-"Help me create a mapping between these two tables for data migration"
-
----
-
-## Requirements
-
-* Node.js 14+ installed on your machine
-* Python 3.10+ installed on your machine (automatically detected)
-* Airtable Personal Access Token (API Key)
-* MCP Client Application (Cursor, Claude Desktop, Cline, Zed, etc.)
-
-**Note**: Model Context Protocol (MCP) is specific to Anthropic models. When using an editor like Cursor, make sure to enable composer agent with Claude 3.5 Sonnet selected as the model.
-
----
-
-## Installation
-
-### 1. Install via Smithery (Easiest)
-
-The easiest way to install Airtable MCP is through Smithery:
-
-1. Visit [Smithery](https://smithery.ai)
-2. Search for "@rashidazarang/airtable-mcp"
-3. Click "Install" and follow the prompts to configure with your Airtable token and base ID
-
-### 2. Install via NPX (Alternative)
-
-Another simple way to install and use Airtable MCP is via NPX:
-
-```bash
-# Install globally
-npm install -g airtable-mcp
-
-# Or use directly with npx (no installation needed)
-npx airtable-mcp --token YOUR_AIRTABLE_TOKEN --base YOUR_BASE_ID
-```
-
-### 3. Get Your Airtable API Token
-
-1. Log in to your Airtable account
-2. Go to your [Account Settings](https://airtable.com/account)
-3. Navigate to the "API" section
-4. Create a Personal Access Token with appropriate permissions
-5. Copy your token to use in the configuration
-
-### 4. Configure Your MCP Client
-
-#### For Cursor:
-
-1. Go to Cursor Settings
-2. Navigate to Features, scroll down to MCP Servers and click "Add new MCP server"
-3. Give it a unique name (airtable-tools), set type to "command" and set the command to:
-
-**For macOS/Linux/Windows:**
-```bash
-npx airtable-mcp --token YOUR_AIRTABLE_TOKEN --base YOUR_BASE_ID
-```
-
-Replace `YOUR_AIRTABLE_TOKEN` with your Airtable Personal Access Token and `YOUR_BASE_ID` with your default Airtable base ID (optional).
-
-#### For Advanced Users via ~/.cursor/mcp.json:
-
-Edit your `~/.cursor/mcp.json` file to include:
-
-```json
-{
-  "mcpServers": {
-    "airtable-tools": {
-      "command": "npx",
-      "args": [
-        "airtable-mcp",
-        "--token", "YOUR_AIRTABLE_TOKEN",
-        "--base", "YOUR_BASE_ID"
-      ]
-    }
-  }
-}
-```
-
-### 5. Verify Connection
-
-1. Restart your MCP client (Cursor, etc.)
-2. Create a new query using the Composer Agent with Claude 3.5 Sonnet model
-3. Ask something like "List my Airtable bases" or "Show me the tables in my current base"
-4. You should see a response with your Airtable data
-
-### 6. For Production Use (Optional)
-
-For continuous availability, you can set up Airtable MCP using PM2:
-
-```bash
-# Install PM2 if you don't have it
-npm install -g pm2
-
-# Create a PM2 config file
-echo 'module.exports = {
-  apps: [
-    {
-      name: "airtable-mcp",
-      script: "npx",
-      args: [
-        "airtable-mcp",
-        "--token", "YOUR_AIRTABLE_TOKEN",
-        "--base", "YOUR_BASE_ID"
-      ],
-      env: {
-        PATH: process.env.PATH,
-      },
-    },
-  ],
-};' > ecosystem.config.js
-
-# Start the process
-pm2 start ecosystem.config.js
-
-# Set it to start on boot
-pm2 startup
-pm2 save
-```
-
----
-
-## Troubleshooting
-
-Here are some common issues and their solutions:
-
-### Error: Unable to connect to Airtable API
-
-- Double-check your Airtable API token is correct and has sufficient permissions
-- Verify your internet connection
-- Check if Airtable API is experiencing downtime
-
-### Issue: MCP server not connecting
-
-- Make sure Node.js 14+ and Python 3.10+ are installed and in your PATH
-- Try specifying a specific version: `npx airtable-mcp@latest`
-- Check the Cursor logs for any connection errors
-
-### Error: Base not found
-
-- Verify your base ID is correct
-- Make sure your API token has access to the specified base
-- Try listing all bases first to confirm access
-
-### Issue: Permission denied errors
-
-- Make sure your token has the necessary permissions for the operations you're trying to perform
-- Check if you're attempting operations on tables/bases that your token doesn't have access to
-
-### For more help
-
-- Open an issue on the [GitHub repository](https://github.com/rashidazarang/airtable-mcp/issues)
-- Check the Airtable API documentation for any API-specific errors