Twilio MCP Server

Twilio MCP Server

Un servidor de Model Context Protocol (MCP) que permite a Claude y otros asistentes de IA enviar mensajes SMS y MMS usando Twilio.

Demo

Características

• Enviar mensajes SMS 📱
• Prompts predefinidos para escenarios comunes de mensajería 📝
• Manejo seguro de credenciales de Twilio 🔒

Requisitos

• Node.js >= 18
  • Si necesitas actualizar Node.js, recomendamos usar nvm (Node Version Manager):

    nvm install 18.14.2
    nvm alias default 18.14.2
    

  • Si encuentras errores en Claude Desktop, intenta ejecutar el siguiente comando en tu terminal para verificar la instalación:

    npx -y @yiyang.1i/sms-mcp-server
    

Configuración

El servidor requiere tres variables de entorno:

• ACCOUNT_SID: Tu SID de cuenta de Twilio
• AUTH_TOKEN: Tu token de autenticación de Twilio
• FROM_NUMBER: Tu número de teléfono de Twilio (en formato E.164, por ejemplo, +11234567890)

Configuración de Claude Desktop

Para usar este servidor con Claude Desktop, agrega lo siguiente a tu archivo de configuración:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "twilio": {
      "command": "npx",
      "args": [
        "-y",
        "@yiyang.1i/sms-mcp-server"
      ],
      "env": {
        "ACCOUNT_SID": "your_account_sid",
        "AUTH_TOKEN": "your_auth_token",
        "FROM_NUMBER": "your_twilio_number"
      }
    }
  }
}

Después de eso, reinicia Claude Desktop para recargar la configuración. Si está conectado, deberías ver Twilio en el menú 🔨.

Ejemplos de interacción con Claude

Aquí hay algunas formas naturales de interactuar con el servidor a través de Claude:

1. SMS simple:

Send a text message to the number +11234567890 saying "Don't forget about dinner tonight!"

2. SMS creativo:

Write a haiku about autumn and send it to my number +11234567890

Notas importantes

1. Formato de número de teléfono: Todos los números de teléfono deben estar en formato E.164 (por ejemplo, +11234567890)
2. Límites de tasa: Ten en cuenta los límites de tasa y precios de tu cuenta de Twilio
3. Seguridad: Mantén tus credenciales de Twilio seguras y nunca las envíes al control de versiones

Solución de problemas

Mensajes de error comunes y soluciones:

1. "El número de teléfono debe estar en formato E.164"

   • Asegúrate de que el número de teléfono comience con "+" y el código de país

2. "Credenciales inválidas"

   • Verifica tu ACCOUNT_SID y AUTH_TOKEN. Puedes copiarlos desde la Consola de Twilio

Contribuciones

¡Las contribuciones son bienvenidas! Por favor, lee nuestras pautas de contribución antes de enviar solicitudes de extracción.

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.

Seguridad

Por favor, no incluyas información sensible (como números de teléfono o credenciales de Twilio) en problemas o solicitudes de extracción de GitHub.