Switch to simplified Twilio MCP integration using @yiyang.1i/sms-mcp-server

- Replace API Key/Secret auth with Account SID/Auth Token - Configure MCP during Docker build instead of runtime - Remove mcp-config.json and config directory - Simplify startup script by removing MCP configuration logic - Update documentation and test scripts for new auth method The MCP server is now configured directly in the Dockerfile using 'claude mcp add-json' command, making the setup more reliable and eliminating runtime configuration complexity.
2025-06-17 21:48:00 +01:00 · 2025-06-17 21:48:00 +01:00 · d9bf0f4b53
commit d9bf0f4b53
parent 6cb57c9dc6
8 changed files with 63 additions and 60 deletions
--- a/.env.example
+++ b/.env.example
@ -6,7 +6,6 @@ ANTHROPIC_API_KEY=your_anthropic_api_key_here

 # Optional: Twilio credentials for SMS notifications
 TWILIO_ACCOUNT_SID=your_twilio_account_sid
-TWILIO_API_KEY=your_twilio_api_key
-TWILIO_API_SECRET=your_twilio_api_secret
+TWILIO_AUTH_TOKEN=your_twilio_auth_token
 TWILIO_FROM_NUMBER=+1234567890
 TWILIO_TO_NUMBER=+0987654321
--- a/18
+++ b/18
@ -28,14 +28,8 @@ RUN npm install -g @anthropic-ai/claude-code
 # Ensure npm global bin is in PATH
 ENV PATH="/usr/local/bin:${PATH}"

-# Install Twilio MCP server
-RUN npm install -g @twilio-alpha/mcp
-
 # Create directories for configuration
-RUN mkdir -p /app/config /app/.claude /home/claude-user/.claude
-
-# Copy MCP configuration
-COPY config/mcp-config.json /app/config/
+RUN mkdir -p /app/.claude /home/claude-user/.claude

 # Copy startup script
 COPY scripts/startup.sh /app/
@ -51,6 +45,16 @@ RUN chown -R claude-user:claude-user /app /home/claude-user
 # Switch to non-root user
 USER claude-user

+# Configure MCP server during build if Twilio credentials are provided
+RUN bash -c 'source /app/.env && \
+    if [ -n "$TWILIO_ACCOUNT_SID" ] && [ -n "$TWILIO_AUTH_TOKEN" ]; then \
+        echo "Configuring Twilio MCP server..." && \
+        /usr/local/bin/claude mcp add-json twilio \
+        "{\"command\":\"npx\",\"args\":[\"-y\",\"@yiyang.1i/sms-mcp-server\"],\"env\":{\"ACCOUNT_SID\":\"$TWILIO_ACCOUNT_SID\",\"AUTH_TOKEN\":\"$TWILIO_AUTH_TOKEN\",\"FROM_NUMBER\":\"$TWILIO_FROM_NUMBER\"}}"; \
+    else \
+        echo "No Twilio credentials found, skipping MCP configuration"; \
+    fi'
+
 # Set working directory to mounted volume
 WORKDIR /workspace

--- a/README.md
+++ b/README.md
@ -33,8 +33,7 @@ A Docker container setup for running Claude Code with full autonomous permission
   
   # For Twilio MCP integration (optional):
   TWILIO_ACCOUNT_SID=your_twilio_sid  
-   TWILIO_API_KEY=your_twilio_api_key
-   TWILIO_API_SECRET=your_twilio_api_secret
+   TWILIO_AUTH_TOKEN=your_twilio_auth_token
   TWILIO_FROM_NUMBER=your_twilio_number
   TWILIO_TO_NUMBER=your_phone_number
   ```
@ -44,7 +43,7 @@ A Docker container setup for running Claude Code with full autonomous permission
   > - You can use the image from any directory without needing the .env file
   > - Keep your image secure since it contains your credentials
   
-   > **Note**: Twilio MCP requires API Key/Secret instead of Auth Token. Create API keys in your Twilio Console under Account → API keys & tokens.
+   > **Note**: Twilio MCP uses Account SID and Auth Token. You can find these in your Twilio Console.

 3. **Build and install:**
   ```bash
@ -138,8 +137,6 @@ claude-docker/
 │   ├── claude-docker.sh   # Wrapper script for container
 │   ├── install.sh         # Installation script  
 │   └── startup.sh         # Container startup script
-├── config/
-│   └── mcp-config.json   # MCP server configuration
 └── templates/
    └── scratchpad.md     # Template for project context
 ```
--- a/config/mcp-config.json
+++ b/config/mcp-config.json
@ -1,24 +0,0 @@
-{
-  "mcpServers": {
-    "twilio": {
-      "type": "stdio",
-      "command": "npx",
-      "args": [
-        "-y",
-        "@twilio-alpha/mcp",
-        "${TWILIO_ACCOUNT_SID}/${TWILIO_API_KEY}:${TWILIO_API_SECRET}",
-        "--services",
-        "twilio_api_v2010",
-        "--tags",
-        "Api20100401Message"
-      ],
-      "env": {
-        "TWILIO_ACCOUNT_SID": "${TWILIO_ACCOUNT_SID}",
-        "TWILIO_API_KEY": "${TWILIO_API_KEY}",
-        "TWILIO_API_SECRET": "${TWILIO_API_SECRET}",
-        "TWILIO_FROM_NUMBER": "${TWILIO_FROM_NUMBER}",
-        "TWILIO_TO_NUMBER": "${TWILIO_TO_NUMBER}"
-      }
-    }
-  }
-}
--- a/scratchpad.md
+++ b/scratchpad.md
@ -128,6 +128,41 @@ Building a Docker container that runs Claude Code with full autonomous permissio
  - Tokens stored in temp locations that get cleared
  - Need to find exact token storage location and persist it

+## MCP Integration Update (2024-12-17)
+
+### ✅ COMPLETED: Simplified Twilio MCP Integration
+
+**What Changed:**
+1. **Switched MCP Server:** From `@twilio-alpha/mcp` (API Key/Secret) to `@yiyang.1i/sms-mcp-server` (Auth Token)
+2. **Simplified Configuration:** MCP setup now happens during Docker build instead of runtime
+3. **Removed Complexity:** No more mcp-config.json or environment variable substitution
+
+**Implementation Details:**
+1. **Updated .env.example:**
+   - Removed: `TWILIO_API_KEY` and `TWILIO_API_SECRET`
+   - Added: `TWILIO_AUTH_TOKEN`
+   - Kept: `TWILIO_ACCOUNT_SID`, `TWILIO_FROM_NUMBER`, `TWILIO_TO_NUMBER`
+
+2. **Updated Dockerfile:**
+   - Removed global installation of `@twilio-alpha/mcp`
+   - Added MCP configuration during build using `claude mcp add-json` command
+   - MCP server is configured if Twilio credentials are present in .env
+
+3. **Simplified startup.sh:**
+   - Removed all MCP configuration logic
+   - Just loads environment variables and starts Claude
+   - Shows Twilio status on startup
+
+4. **Removed Files:**
+   - `config/mcp-config.json` (no longer needed)
+   - `config/` directory (now empty)
+
+**Result:**
+- MCP configuration is baked into the Docker image at build time
+- No runtime configuration needed
+- Simpler, more reliable setup
+- SMS capability available via `twilio__send_text` command
+
 ## Quick References
 - Install: `./scripts/install.sh`
 - Usage: `claude-docker` (from any project directory)
--- a/scripts/setup-env.sh
+++ b/scripts/setup-env.sh
@ -24,8 +24,7 @@ echo

 # Collect Twilio credentials
 read -p "Enter your Twilio Account SID: " TWILIO_ACCOUNT_SID
-read -p "Enter your Twilio API Key: " TWILIO_API_KEY
-read -sp "Enter your Twilio API Secret: " TWILIO_API_SECRET
+read -sp "Enter your Twilio Auth Token: " TWILIO_AUTH_TOKEN
 echo
 read -p "Enter your Twilio phone number (with country code, e.g., +1234567890): " TWILIO_FROM_NUMBER
 read -p "Enter the phone number to receive SMS (with country code): " TWILIO_TO_NUMBER
@ -34,8 +33,7 @@ read -p "Enter the phone number to receive SMS (with country code): " TWILIO_TO_
 cat > "$ENV_FILE" << EOF
 # Twilio credentials for Claude Docker
 TWILIO_ACCOUNT_SID=$TWILIO_ACCOUNT_SID
-TWILIO_API_KEY=$TWILIO_API_KEY
-TWILIO_API_SECRET=$TWILIO_API_SECRET
+TWILIO_AUTH_TOKEN=$TWILIO_AUTH_TOKEN
 TWILIO_FROM_NUMBER=$TWILIO_FROM_NUMBER
 TWILIO_TO_NUMBER=$TWILIO_TO_NUMBER
 EOF
--- a/scripts/startup.sh
+++ b/scripts/startup.sh
@ -1,29 +1,24 @@
 #!/bin/bash
 # ABOUTME: Startup script for Claude Code container with MCP server
-# ABOUTME: Configures environment and starts Claude Code with Twilio MCP integration
+# ABOUTME: Loads environment and starts Claude Code with pre-configured Twilio MCP

 # Load environment variables from .env if it exists
 # Use the .env file baked into the image at build time
 if [ -f /app/.env ]; then
-    echo "Loading credentials from baked-in .env file"
+    echo "Loading environment from baked-in .env file"
    set -a
    source /app/.env 2>/dev/null || true
    set +a
    
-    # Export Twilio variables for MCP server
+    # Export Twilio variables for runtime use
    export TWILIO_ACCOUNT_SID
-    export TWILIO_API_KEY
-    export TWILIO_API_SECRET
+    export TWILIO_AUTH_TOKEN
    export TWILIO_FROM_NUMBER
    export TWILIO_TO_NUMBER
 else
-    echo "WARNING: No .env file found in image. Twilio features will be unavailable."
-    echo "To enable Twilio: create .env in claude-docker directory before building the image."
+    echo "WARNING: No .env file found in image."
 fi

-# Configure Claude Code to use the MCP server
-export CLAUDE_MCP_CONFIG=/app/config/mcp-config.json
-
 # Check for existing authentication
 if [ -f "$HOME/.claude/.credentials.json" ]; then
    echo "Found existing Claude authentication"
@ -33,14 +28,14 @@ else
 fi

 # Verify Twilio MCP configuration
-if [ -n "$TWILIO_ACCOUNT_SID" ] && [ -n "$TWILIO_API_KEY" ] && [ -n "$TWILIO_API_SECRET" ]; then
-    echo "Twilio MCP pre-configured with:"
+if [ -n "$TWILIO_ACCOUNT_SID" ] && [ -n "$TWILIO_AUTH_TOKEN" ]; then
+    echo "Twilio MCP server configured with:"
    echo "  - Account SID: ${TWILIO_ACCOUNT_SID:0:10}..."
    echo "  - From Number: $TWILIO_FROM_NUMBER"
    echo "  - To Number: $TWILIO_TO_NUMBER"
-    echo "  - MCP Config: $CLAUDE_MCP_CONFIG"
+    echo "  - SMS capability ready via: twilio__send_text"
 else
-    echo "No Twilio credentials found, MCP features will be unavailable"
+    echo "No Twilio credentials found"
 fi

 # Start Claude Code with permissions bypass
--- a/test-twilio.js
+++ b/test-twilio.js
@ -2,21 +2,20 @@

 // Test script to verify Twilio SMS functionality
 const accountSid = process.env.TWILIO_ACCOUNT_SID;
-const authToken = process.env.TWILIO_API_SECRET;
-const apiKey = process.env.TWILIO_API_KEY;
+const authToken = process.env.TWILIO_AUTH_TOKEN;
 const fromNumber = process.env.TWILIO_FROM_NUMBER;
 const toNumber = process.env.TWILIO_TO_NUMBER;

 console.log('Twilio Test Configuration:');
 console.log(`Account SID: ${accountSid?.substring(0, 10)}...`);
-console.log(`API Key: ${apiKey?.substring(0, 10)}...`);
+console.log(`Auth Token: ${authToken ? '***' + authToken.substring(authToken.length - 4) : 'Not set'}`);
 console.log(`From: ${fromNumber}`);
 console.log(`To: ${toNumber}`);

 // Using Twilio REST API directly
 const https = require('https');

-const auth = Buffer.from(`${apiKey}:${authToken}`).toString('base64');
+const auth = Buffer.from(`${accountSid}:${authToken}`).toString('base64');
 const data = new URLSearchParams({
    To: toNumber,
    From: fromNumber,