@rashidazarang/airtable-mcp 1.6.0 → 2.1.1

package/MCP_REVIEW_SUMMARY.md

@@ -1,142 +0,0 @@
-# Airtable MCP Review Summary
-
-## 🎯 Overall Assessment: **WORKING ✅**
-
-The Airtable MCP is **fully functional** and ready for use. All core functionality has been tested and verified.
-
-## 📋 Test Results
-
-### ✅ **What's Working**
-
-1. **MCP Server Implementation**
-   - Simple JavaScript server (`airtable_simple.js`) is fully operational
-   - Running on port 8010 with proper HTTP/JSON-RPC protocol
-   - Correctly handles all MCP method calls
-
-2. **Airtable API Integration**
-   - Successfully connects to Airtable API using Personal Access Token
-   - Can access multiple bases (103 bases available with test token)
-   - Target base "ayudalocal.mex" (ID: appi7fWMQcB3BNzPs) is accessible
-   - Contains 11 tables with various field types
-
-3. **MCP Tools Functionality**
-   - ✅ `list_tables` - Lists all tables in the base
-   - ✅ `list_records` - Retrieves records from any table
-   - ✅ `resources/list` - Returns available MCP resources
-   - ✅ `prompts/list` - Returns available MCP prompts
-
-4. **Data Access**
-   - Successfully retrieved records from multiple tables:
-     - **requests** table (service requests)
-     - **providers** table (service providers)
-     - **categories** table (service categories)
-     - **coverage_areas** table
-     - **services** table
-     - And 6 other tables
-
-5. **JSON-RPC Protocol**
-   - Properly implements JSON-RPC 2.0 specification
-   - Correct error handling and response formatting
-   - Valid JSON responses for all requests
-
-### ⚠️ **Issues Found & Fixed**
-
-1. **Python MCP Server Compatibility**
-   - **Issue**: `app.rpc_method` not available in MCP version 1.4.1
-   - **Fix**: Removed incompatible rpc_method calls from `inspector_server.py`
-   - **Status**: Fixed and ready for use
-
-2. **Main Entry Point**
-   - **Issue**: Node.js `index.js` had dependency on Python server with compatibility issues
-   - **Status**: Simple JavaScript server works perfectly as alternative
-
-## 🧪 **Comprehensive Testing Performed**
-
-### Test Coverage
-- ✅ MCP server startup and initialization
-- ✅ Airtable API authentication and connection
-- ✅ Base listing and access verification
-- ✅ Table listing and schema inspection
-- ✅ Record retrieval from multiple tables
-- ✅ JSON-RPC protocol compliance
-- ✅ Error handling and response formatting
-- ✅ HTTP server functionality
-- ✅ CORS handling for web clients
-
-### Test Data Verified
-- **Base**: ayudalocal.mex (ID: appi7fWMQcB3BNzPs)
-- **Tables**: 11 tables with complex schemas
-- **Records**: Successfully retrieved from requests, providers, categories tables
-- **Fields**: Various field types including text, dates, numbers, attachments, links
-
-## 🚀 **Ready for Production Use**
-
-### Recommended Setup
-```bash
-# Start the MCP server
-node airtable_simple.js --token YOUR_AIRTABLE_TOKEN --base YOUR_BASE_ID
-```
-
-### Configuration for Claude Desktop
-```json
-{
-  "mcpServers": {
-    "airtable-mcp": {
-      "command": "node",
-      "args": [
-        "/path/to/airtable-mcp-main/airtable_simple.js",
-        "--token",
-        "YOUR_AIRTABLE_TOKEN",
-        "--base",
-        "YOUR_BASE_ID"
-      ]
-    }
-  }
-}
-```
-
-## 📊 **Performance Metrics**
-
-- **Response Time**: < 500ms for most operations
-- **Reliability**: 100% success rate in testing
-- **Data Accuracy**: All retrieved data matches Airtable base
-- **Error Handling**: Proper error messages and status codes
-
-## 🔧 **Technical Architecture**
-
-### Working Components
-1. **Simple JavaScript Server** (`airtable_simple.js`)
-   - HTTP server on port 8010
-   - JSON-RPC 2.0 implementation
-   - Direct Airtable API integration
-   - CORS support for web clients
-
-2. **Airtable API Integration**
-   - Personal Access Token authentication
-   - RESTful API calls to Airtable
-   - Proper error handling and retry logic
-
-3. **MCP Protocol Implementation**
-   - Standard MCP tool definitions
-   - Proper JSON-RPC request/response handling
-   - Resource and prompt listing support
-
-## 🎉 **Conclusion**
-
-The Airtable MCP is **fully functional and production-ready**. The simple JavaScript implementation provides all necessary functionality for connecting AI tools to Airtable databases. The MCP successfully:
-
-- Connects to Airtable API
-- Lists and accesses bases and tables
-- Retrieves and displays records
-- Implements proper MCP protocol
-- Handles errors gracefully
-
-**Recommendation**: Use the `airtable_simple.js` server for production deployments as it's stable, well-tested, and provides all required functionality.
-
----
-
-*Review completed on: January 15, 2025*
-*Test environment: macOS, Node.js v23.9.0, Python 3.10.16*
-*MCP version tested: 1.4.1*
-
-

package/QUICK_START.md

@@ -1,60 +0,0 @@
-# Quick Start Guide for Claude Users
-
-This guide provides simple instructions for getting the Airtable MCP working with Claude.
-
-## Step 1: Clone the repository
-
-```bash
-git clone https://github.com/rashidazarang/airtable-mcp.git
-cd airtable-mcp
-```
-
-## Step 2: Install dependencies
-
-```bash
-npm install
-pip install mcp
-```
-
-## Step 3: Configure Claude
-
-In Claude settings, add a new MCP server with this configuration (adjust paths as needed):
-
-```json
-{
-  "mcpServers": {
-    "airtable": {
-      "command": "python3",
-      "args": [
-        "/path/to/airtable-mcp/inspector_server.py",
-        "--token",
-        "YOUR_AIRTABLE_TOKEN",
-        "--base",
-        "YOUR_BASE_ID"
-      ]
-    }
-  }
-}
-```
-
-Replace:
-- `/path/to/airtable-mcp/` with the actual path where you cloned the repository
-- `YOUR_AIRTABLE_TOKEN` with your Airtable Personal Access Token
-- `YOUR_BASE_ID` with your Airtable Base ID
-
-## Step 4: Restart Claude
-
-After configuring, restart Claude and try these commands:
-
-1. "List the tables in my Airtable base"
-2. "Show me records from [table name]"
-
-## Troubleshooting
-
-If you encounter issues:
-
-1. Check the Claude logs (click on the error message)
-2. Verify your Airtable token and base ID are correct
-3. Make sure you've specified the correct path to `inspector_server.py`
-
-This version includes enhanced error handling to properly format JSON responses and avoid "Method not found" errors in Claude. 

package/RELEASE_NOTES_v1.2.0.md

@@ -1,50 +0,0 @@
-# Release v1.2.0: Claude & Windsurf Compatibility
-
-This release addresses compatibility issues with Claude Desktop and Windsurf, while also improving the overall stability of the MCP.
-
-## Key Improvements
-
-### 🔧 Major Fixes
-
-1. **AbortController Compatibility**: Added polyfill for Node.js versions < 15.0.0 
-   - Fixes `ReferenceError: AbortController is not defined` errors
-   - Automatically detects and applies the polyfill when needed
-
-2. **Enhanced JSON Parsing**: Robust handling of malformed JSON configurations
-   - Fixes `Unexpected token 'F', "Found & ig"... is not valid JSON` errors
-   - Adds multiple sanitization steps for JSON in both JavaScript and Python 
-   - Supports backslash-escaped and double-quoted strings
-
-3. **Improved Configuration Options**: Alternative ways to configure the MCP
-   - Added support for direct token and base ID parameters (no JSON required)
-   - Created reference configuration files for different platforms
-
-### 🚀 New Features
-
-1. **Claude and Windsurf Examples**: Added configuration templates
-   - `examples/claude_config.json`: Sample configuration for Claude
-   - `examples/windsurf_mcp_config.json`: Reference config for Windsurf
-
-2. **Comprehensive Documentation**:
-   - Updated `CLAUDE_INTEGRATION.md` with detailed setup guides
-   - Added troubleshooting steps for common issues
-
-## Installation
-
-### NPM
-```
-npm install -g @rashidazarang/airtable-mcp
-```
-
-### Direct Download
-Download the tarball package: `rashidazarang-airtable-mcp-1.2.0.tgz`
-
-## Upgrading from v1.1.0
-
-If you're upgrading from v1.1.0, you can simply install the new version:
-
-```
-npm update -g @rashidazarang/airtable-mcp
-```
-
-For Claude and Windsurf users, we recommend following the updated configuration instructions in `CLAUDE_INTEGRATION.md`. 

package/RELEASE_NOTES_v1.2.1.md

@@ -1,40 +0,0 @@
-# Release v1.2.1: Enhanced Claude Integration
-
-This release adds specific improvements for Claude users, focusing on eliminating error messages and providing a smoother experience when using the MCP with Claude Desktop and other Claude integrations.
-
-## Key Improvements
-
-### 🚀 Claude-specific Methods
-
-1. **Added support for Claude-specific RPC methods**:
-   - Implemented `resources/list` method
-   - Implemented `prompts/list` method
-
-2. **User Experience Enhancements**:
-   - Eliminated "Method not found" errors in logs
-   - Improved compatibility with Claude's native UI components
-   - Added suggested prompts for common Airtable operations
-
-## Installation
-
-### NPM
-```
-npm install -g @rashidazarang/airtable-mcp@1.2.1
-```
-
-### Direct Download
-Download the tarball package: `rashidazarang-airtable-mcp-1.2.1.tgz`
-
-## Upgrading from Previous Versions
-
-If you're upgrading from v1.2.0 or earlier, you can simply install the new version:
-
-```
-npm update -g @rashidazarang/airtable-mcp
-```
-
-For Claude users, this update is especially recommended as it will eliminate error messages and provide a more seamless integration experience.
-
-## Configuration
-
-No configuration changes are needed to benefit from these improvements. The Claude-specific methods are automatically available when using Claude with this MCP version. 

package/RELEASE_NOTES_v1.2.2.md

@@ -1,48 +0,0 @@
-# Release Notes - v1.2.2
-
-## Major Improvements
-
-### Documentation & Setup
-- Completely revamped documentation with focus on Claude Desktop integration
-- Added clear step-by-step installation guide
-- Simplified configuration process with working JSON examples
-- Added detailed troubleshooting section
-
-### Configuration
-- Removed complex JSON configuration in favor of simpler format
-- Fixed JSON parsing issues with Claude Desktop
-- Updated configuration file path for Claude Desktop
-- Removed unnecessary escape characters in configuration
-
-### Integration
-- Improved Claude Desktop compatibility
-- Added 30-second connection establishment guidance
-- Added verification steps with example commands
-- Enhanced error handling and logging guidance
-
-## Technical Updates
-- Updated dependencies to latest versions
-- Added @smithery/cli as direct dependency
-- Updated Airtable SDK to v0.12.2
-- Improved Node.js version compatibility
-
-## Bug Fixes
-- Fixed JSON parsing errors in Claude Desktop
-- Resolved connection timeout issues
-- Fixed configuration file path issues
-- Improved error messaging
-
-## Breaking Changes
-- Configuration format has changed to use direct parameters instead of JSON config string
-- Removed support for complex JSON configurations
-- Changed default configuration file location for Claude Desktop
-
-## Migration Guide
-If upgrading from v1.2.1 or earlier:
-1. Update your configuration file to use the new format
-2. Remove any escape characters from your token
-3. Restart Claude Desktop after changes
-4. Wait 30 seconds for connection to establish
-
-## Contributors
-- @rashidazarang 

package/RELEASE_NOTES_v1.2.3.md

@@ -1,105 +0,0 @@
-# Release Notes v1.2.3
-
-## 🎉 **Major Improvements**
-
-### ✅ **Fixed Critical Issues**
-- **Fixed main entry point**: Updated `package.json` to use `airtable_simple.js` as the main entry point
-- **Added proper npm scripts**: Added `test`, `test:quick`, `start:python`, and `dev` scripts
-- **Fixed Python compatibility**: Removed incompatible `app.rpc_method` calls from `inspector_server.py`
-- **Updated documentation**: Completely rewrote README with working configuration examples
-
-### 🚀 **New Features**
-- **Comprehensive testing suite**: Added `test_mcp_comprehensive.js` for full MCP testing
-- **Quick testing script**: Added `quick_test.sh` for rapid verification
-- **Cleanup utilities**: Added `cleanup.sh` for easy server management
-- **Development guide**: Added `DEVELOPMENT.md` for contributors
-
-### 📚 **Documentation Improvements**
-- **Clear architecture overview**: Documented working vs legacy components
-- **Multiple setup options**: Direct usage and Smithery cloud options
-- **Troubleshooting guide**: Common issues and solutions
-- **Testing instructions**: Step-by-step testing procedures
-
-### 🛠️ **Developer Experience**
-- **Better npm scripts**: `npm run test`, `npm run test:quick`, `npm start`
-- **Port management**: Easy port clearing with `lsof -ti:8010 | xargs kill -9`
-- **Error handling**: Improved error messages and debugging
-- **Code organization**: Clear separation of working and legacy code
-
-## 🔧 **Technical Changes**
-
-### **Package.json Updates**
-```json
-{
-  "main": "airtable_simple.js",
-  "bin": {
-    "airtable-mcp": "./airtable_simple.js"
-  },
-  "scripts": {
-    "start": "node airtable_simple.js",
-    "test": "node test_mcp_comprehensive.js",
-    "test:quick": "./quick_test.sh"
-  }
-}
-```
-
-### **Recommended Configuration**
-```json
-{
-  "mcpServers": {
-    "airtable-mcp": {
-      "command": "node",
-      "args": [
-        "/path/to/airtable-mcp-main/airtable_simple.js",
-        "--token",
-        "YOUR_AIRTABLE_TOKEN",
-        "--base",
-        "YOUR_BASE_ID"
-      ]
-    }
-  }
-}
-```
-
-## 🧪 **Testing Results**
-- ✅ **100% test success rate** on all MCP operations
-- ✅ **Airtable API integration** working perfectly
-- ✅ **JSON-RPC 2.0 protocol** fully compliant
-- ✅ **Error handling** robust and informative
-- ✅ **CORS support** for web clients
-
-## 📊 **Performance**
-- **Response time**: < 500ms for most operations
-- **Reliability**: 100% success rate in testing
-- **Memory usage**: Minimal footprint
-- **Scalability**: Handles multiple concurrent requests
-
-## 🎯 **Migration Guide**
-
-### **From Previous Versions**
-1. **Update configuration**: Use the new direct Node.js configuration
-2. **Test your setup**: Run `npm run test:quick` to verify
-3. **Update documentation**: Follow the new README instructions
-
-### **Breaking Changes**
-- **Main entry point**: Now uses `airtable_simple.js` instead of `index.js`
-- **Python server**: Deprecated due to compatibility issues
-- **Configuration format**: Simplified JSON structure
-
-## 🚀 **What's Next**
-- Enhanced error reporting
-- Additional Airtable operations (create, update, delete)
-- Better field type handling
-- Performance optimizations
-
-## 📝 **Contributors**
-- Rashid Azarang (maintainer)
-- Community testing and feedback
-
----
-
-**Release Date**: January 15, 2025  
-**Compatibility**: Node.js >= 14.0.0, MCP 1.4.1+  
-**Status**: Production Ready ✅
-
-

package/RELEASE_NOTES_v1.2.4.md

@@ -1,60 +0,0 @@
-# Release Notes - v1.2.4
-
-## 🔒 Security Fix Release
-
-### Critical Security Fix
-- **REMOVED hardcoded API tokens from test files** (Addresses Issue #7)
-  - `test_client.py` and `test_mcp_comprehensive.js` now require environment variables
-  - Added security notice documentation
-  - No exposed credentials in the codebase
-
-### 🐛 Bug Fixes
-
-#### Smithery Cloud Deployment Issues (Issues #5 and #6)
-- **Fixed HTTP 400 errors** when using Smithery
-- **Switched to JavaScript implementation** for Smithery deployment
-- Updated `smithery.yaml` to use `airtable_simple.js` instead of problematic Python server
-- Created dedicated `Dockerfile.node` for Node.js deployment
-- Fixed authentication flow for Smithery connections
-
-### 📚 Documentation Updates
-- Added `SECURITY_NOTICE.md` with token rotation instructions
-- Created `.env.example` file for secure configuration
-- Updated Dockerfile references for Glama listing (Issue #4)
-
-### 🔧 Improvements
-- Added environment variable support with dotenv
-- Improved logging system with configurable levels (ERROR, WARN, INFO, DEBUG)
-- Better error messages for missing credentials
-
-### ⚠️ Breaking Changes
-- Test files now require environment variables:
-  ```bash
-  export AIRTABLE_TOKEN="your_token"
-  export AIRTABLE_BASE_ID="your_base_id"
-  ```
-
-### 🚀 Migration Guide
-
-1. **Update your environment variables:**
-   ```bash
-   cp .env.example .env
-   # Edit .env with your credentials
-   ```
-
-2. **For Smithery users:**
-   - Reinstall the MCP to get the latest configuration
-   - The server now properly accepts credentials through Smithery's config
-
-3. **For direct users:**
-   - Continue using command line arguments or switch to environment variables
-   - Both methods are supported
-
-### 📝 Notes
-- All previously exposed tokens have been revoked
-- Please use your own Airtable credentials
-- Never commit API tokens to version control
-
----
-
-**Full Changelog**: [v1.2.3...v1.2.4](https://github.com/rashidazarang/airtable-mcp/compare/v1.2.3...v1.2.4)

package/RELEASE_NOTES_v1.4.0.md

@@ -1,104 +0,0 @@
-# Release Notes - v1.4.0
-
-## 🚀 Major Feature Release
-
-### ✨ New Features
-
-#### 🪝 **Webhook Management** (5 new tools)
-- `list_webhooks` - List all webhooks in your base
-- `create_webhook` - Create webhooks for real-time notifications
-- `delete_webhook` - Remove webhooks
-- `get_webhook_payloads` - Retrieve webhook payload history
-- `refresh_webhook` - Extend webhook expiration time
-
-#### 🔧 **Enhanced CRUD Operations** (5 tools added since v1.2.4)
-- `create_record` - Create new records in any table
-- `update_record` - Update existing records
-- `delete_record` - Remove records from tables
-- `get_record` - Retrieve single record by ID
-- `search_records` - Advanced filtering with Airtable formulas
-
-### 📊 **Complete Tool Set (12 tools total)**
-1. **list_tables** - List all tables in base
-2. **list_records** - List records from table
-3. **get_record** - Get single record by ID
-4. **create_record** - Create new records
-5. **update_record** - Update existing records
-6. **delete_record** - Delete records
-7. **search_records** - Search with filters
-8. **list_webhooks** - List webhooks
-9. **create_webhook** - Create webhooks
-10. **delete_webhook** - Delete webhooks
-11. **get_webhook_payloads** - Get webhook history
-12. **refresh_webhook** - Refresh webhook expiration
-
-### 🔐 **Security Improvements**
-- Environment variable support for credentials
-- Token masking in logs
-- Configurable logging levels (ERROR, WARN, INFO, DEBUG)
-- No hardcoded credentials in test files
-
-### 🛠️ **Technical Improvements**
-- Full HTTP method support (GET, POST, PATCH, DELETE)
-- Enhanced error handling with detailed messages
-- Proper API endpoint routing
-- Debug logging support
-- Graceful shutdown handling
-
-### 📈 **Testing**
-- **100% test coverage** - All 12 tools tested and verified
-- Tested with real Airtable API
-- Comprehensive test suite included
-- Test scripts for validation
-
-### 💔 **Breaking Changes**
-- Test files now require environment variables:
-  ```bash
-  export AIRTABLE_TOKEN="your_token"
-  export AIRTABLE_BASE_ID="your_base_id"
-  ```
-
-### 🔄 **Migration from v1.2.4**
-
-1. **Update package**:
-   ```bash
-   npm install -g @rashidazarang/airtable-mcp@latest
-   ```
-
-2. **Set credentials** (choose one method):
-   - Environment variables
-   - Command line arguments
-   - .env file
-
-3. **Update configuration** if using webhooks
-
-### 📝 **Webhook Usage Example**
-
-```javascript
-// Create a webhook
-{
-  "name": "create_webhook",
-  "arguments": {
-    "notificationUrl": "https://your-endpoint.com/webhook"
-  }
-}
-
-// The response includes:
-// - Webhook ID
-// - MAC secret (save this - shown only once!)
-// - Expiration time
-```
-
-### 🎯 **What's Next**
-- Batch operations support
-- Comment management
-- Attachment handling
-- Schema modification tools
-
-### 🙏 **Acknowledgments**
-- Thanks to all testers and contributors
-- Special thanks for the comprehensive testing feedback
-
----
-
-**Full Changelog**: [v1.2.4...v1.4.0](https://github.com/rashidazarang/airtable-mcp/compare/v1.2.4...v1.4.0)