@rashidazarang/airtable-mcp 2.1.0 → 2.1.1

package/ISSUE_RESPONSES.md

@@ -1,171 +0,0 @@
-# GitHub Issue Responses
-
-## Issue #7: Personal Access Token Leakage
-
-Thank you for responsibly disclosing this security vulnerability. This has been fixed in v1.2.4.
-
-### Actions Taken:
-✅ Removed all hardcoded tokens from test files
-✅ Updated code to require environment variables for credentials
-✅ Added SECURITY_NOTICE.md with rotation instructions
-✅ The exposed tokens have been invalidated
-
-### Changes Made:
-- `test_client.py` - Now uses environment variables
-- `test_mcp_comprehensive.js` - Now uses environment variables
-- Added `.env.example` file for secure configuration
-- Updated documentation with security best practices
-
-All users should update to v1.2.4 immediately. The exposed tokens are no longer valid, and users must use their own Airtable credentials.
-
-Thank you for helping improve the security of this project!
-
----
-
-## Issue #6: [Server Bug] @rashidazarang/airtable-mcp
-
-This issue has been resolved in v1.2.4! 
-
-### Root Cause:
-The Smithery configuration was using the Python implementation which had compatibility issues with MCP 1.4.1.
-
-### Solution:
-- Updated `smithery.yaml` to use the stable JavaScript implementation (`airtable_simple.js`)
-- Fixed authentication flow to properly handle credentials
-- Added proper environment variable support
-
-### To fix:
-1. Update to v1.2.4: `npm install @rashidazarang/airtable-mcp@latest`
-2. Reconfigure with your credentials as shown in the updated README
-3. Restart Claude Desktop
-
-The server should now connect properly without the "API key is required" error.
-
----
-
-## Issue #5: When Using Smithy, throwing 'Streamable HTTP error: Error POSTing to endpoint (HTTP 400): null'
-
-Fixed in v1.2.4! This was the same root cause as Issue #6.
-
-### What was wrong:
-- The Python server had MCP compatibility issues
-- Authentication wasn't being handled correctly
-- The Smithery configuration was misconfigured
-
-### What we fixed:
-- Switched to the JavaScript implementation
-- Updated smithery.yaml with proper configuration
-- Fixed credential passing through Smithery
-
-### How to resolve:
-```bash
-# Update to latest version
-npm install -g @rashidazarang/airtable-mcp@latest
-
-# Or if using Smithery directly:
-npx @smithery/cli install @rashidazarang/airtable-mcp --update
-```
-
-Then reconfigure with your Airtable credentials. The HTTP 400 errors should be resolved.
-
----
-
-## Issue #4: Glama listing is missing Dockerfile
-
-Fixed in v1.2.4!
-
-### Changes:
-- Created `Dockerfile.node` specifically for Node.js deployment
-- Updated `smithery.yaml` to reference the correct Dockerfile
-- The original Dockerfile is retained for backward compatibility
-
-The Dockerfile is now included and properly configured for cloud deployments.
-
----
-
-# GitHub Release Text for v1.2.4
-
-## 🚨 Critical Security Release - v1.2.4
-
-### ⚠️ IMPORTANT SECURITY FIX
-
-This release addresses a **critical security vulnerability** where API tokens were hardcoded in test files. All users should update immediately.
-
-### 🔒 Security Fixes
-- **Removed hardcoded API tokens** from all test files (fixes #7)
-- Test files now require environment variables for credentials
-- Added comprehensive security documentation
-- Previously exposed tokens have been invalidated
-
-### 🐛 Bug Fixes
-- **Fixed Smithery deployment issues** (fixes #5, #6)
-  - Resolved HTTP 400 errors when connecting through Smithery
-  - Fixed "API key is required for remote connections" error
-  - Switched to stable JavaScript implementation for cloud deployments
-- **Added missing Dockerfile** for Glama listing (fixes #4)
-
-### ✨ Improvements
-- Added environment variable support for secure credential management
-- Improved logging with configurable levels (ERROR, WARN, INFO, DEBUG)
-- Enhanced error messages for better debugging
-- Updated documentation with clear setup instructions
-
-### 📦 What's Changed
-- `test_client.py` - Now uses environment variables
-- `test_mcp_comprehensive.js` - Now uses environment variables  
-- `airtable_simple.js` - Added env variable and logging support
-- `smithery.yaml` - Fixed to use JavaScript implementation
-- `Dockerfile.node` - New optimized Docker image for Node.js
-- `SECURITY_NOTICE.md` - Important security information
-- `README.md` - Complete rewrite with better instructions
-
-### 💔 Breaking Changes
-Test files now require environment variables:
-```bash
-export AIRTABLE_TOKEN="your_token"
-export AIRTABLE_BASE_ID="your_base_id"
-```
-
-### 📋 Migration Instructions
-
-1. **Update to v1.2.4:**
-   ```bash
-   npm install -g @rashidazarang/airtable-mcp@latest
-   ```
-
-2. **Set up environment variables:**
-   ```bash
-   export AIRTABLE_TOKEN="your_personal_token"
-   export AIRTABLE_BASE_ID="your_base_id"
-   ```
-
-3. **Update your MCP configuration** (see README for details)
-
-4. **Restart your MCP client**
-
-### 🙏 Acknowledgments
-Special thanks to @BXXC-SDXZ for responsibly disclosing the security vulnerability, and to @ricklesgibson and @punkpeye for reporting the deployment issues.
-
-### ⚠️ Security Note
-If you were using the previously exposed tokens, they have been revoked. You must use your own Airtable credentials going forward.
-
-**Full Changelog**: https://github.com/rashidazarang/airtable-mcp/compare/v1.2.3...v1.2.4
-
----
-
-## NPM Publish Commands
-
-```bash
-# Make sure you're logged in to npm
-npm login
-
-# Update version (already done in package.json)
-npm version 1.2.4
-
-# Publish to npm
-npm publish --access public
-
-# Create git tag
-git tag -a v1.2.4 -m "Critical security fix and Smithery deployment fixes"
-git push origin v1.2.4
-```

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)