Servidor MCP de mensajería Twilio

Un servidor MCP (Protocolo de contexto de modelo) que permite enviar mensajes SMS a través de la API de Twilio.

Características

• Enviar mensajes SMS a través de Twilio

• Se integra con clientes MCP como Claude Desktop

• Manejo seguro de credenciales sin variables de entorno

• Utiliza claves API de Twilio para mejorar la seguridad

Related MCP server: TTS-MCP

Instalación

Puedes utilizar este servidor directamente a través de npx:

npx twilio-messaging-mcp-server <accountSid> <apiKey> <apiSecret> <number>

O instálelo globalmente:

npm install -g twilio-messaging-mcp-server
twilio-messaging-mcp-server <accountSid> <apiKey> <apiSecret> <number>

Configuración

El servidor requiere los siguientes parámetros:

• accountSid : Su SID de cuenta de Twilio (debe comenzar con 'AC', se validará)

• apiKey : su clave API de Twilio (comienza con 'SK')

• apiSecret : Tu secreto de API de Twilio

• number : el número de teléfono de Twilio desde el que se enviarán mensajes (en formato E.164, por ejemplo, +1234567890)

Nota de seguridad

Este servidor utiliza claves API y secretos en lugar de tokens de autenticación para mejorar la seguridad. Este enfoque proporciona un mejor control de acceso y la posibilidad de revocar credenciales si es necesario. Para más información, consulte la documentación sobre claves API de Twilio .

Uso con Claude Desktop

Desarrollo local

Para el desarrollo local (cuando el paquete no está publicado en npm), agregue lo siguiente a su archivo de configuración de Claude Desktop ( ~/Library/Application Support/Claude/claude_desktop_config.json en macOS o %APPDATA%\Claude\claude_desktop_config.json en Windows):

{
  "mcpServers": {
    "twilio-messaging": {
      "command": "node",
      "args": [
        "/PATHTONODE/twilio-messaging-mcp-server/build/index.js",
        "your_account_sid_here",
        "your_api_key_here",
        "your_api_secret_here",
        "+1234567890"
      ]
    }
  }
}

Reemplace los valores con sus credenciales reales de Twilio:

• Primer argumento: el SID de su cuenta Twilio (comienza con "AC")

• Segundo argumento: Su clave API de Twilio (comienza con "SK")

• Tercer argumento: Su secreto de API de Twilio

• Cuarto argumento: Su número de teléfono de Twilio en formato E.164

Puede obtener la ruta absoluta ejecutando el siguiente comando en el directorio de su proyecto:

# On macOS/Linux
echo "$(pwd)/build/index.js"

# On Windows (PowerShell)
Write-Output "$((Get-Location).Path)\build\index.js"

Después de publicar en npm

Una vez que el paquete se publica en npm, puedes usar la siguiente configuración:

{
  "mcpServers": {
    "twilio-messaging": {
      "command": "npx",
      "args": [
        "-y", 
        "twilio-messaging-mcp-server",
        "your_account_sid_here",
        "your_api_key_here",
        "your_api_secret_here",
        "+1234567890"
      ]
    }
  }
}

Herramientas disponibles

enviar sms

Envía un mensaje SMS a través de Twilio.

Parámetros:

• to : Número de teléfono de destino en formato E.164 (por ejemplo, +1234567890)

• message : Contenido del mensaje a enviar

Ejemplo de uso en Claude:

Can you send an SMS to +1234567890 saying "Hello from MCP!"

Desarrollo

Para construir el proyecto:

npm install
npm run build

Ejecutar el servidor manualmente

Para iniciar el servidor manualmente para realizar pruebas (fuera de Claude Desktop):

# Run with actual credentials
node build/index.js "your_account_sid_here" "your_api_key_here" "your_api_secret" "+1234567890"

# Or use the npm script (which uses ts-node for development)
npm run dev -- "your_account_sid_here" "your_api_key_here" "your_api_secret" "+1234567890"

El servidor se iniciará y esperará las conexiones del cliente MCP. Debería ver un resultado como este:

[TwilioMessagingServer] Server started successfully

Al usar Claude Desktop, el servidor se inicia automáticamente cuando Claude carga el archivo de configuración. No es necesario iniciarlo manualmente.

Licencia

Instituto Tecnológico de Massachusetts (MIT)