Twilio MCP Server

Servidor MCP da Twilio

Um servidor Model Context Protocol (MCP) que permite que o Claude e outros assistentes de IA enviem mensagens SMS e MMS usando a Twilio.

Demonstração

Recursos

• Envio de mensagens SMS 📱
• Prompts pré-construídos para cenários comuns de mensagens 📝
• Tratamento seguro das credenciais da Twilio 🔒

Requisitos

• Node.js >= 18
  • Se você precisar atualizar o Node.js, recomendamos usar o nvm (Node Version Manager):

    nvm install 18.14.2
    nvm alias default 18.14.2
    

  • Se você encontrar erros no Claude Desktop, tente executar o seguinte comando no seu terminal para verificar a instalação:

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

Configuração

O servidor requer três variáveis de ambiente:

• ACCOUNT_SID: Seu SID da conta Twilio
• AUTH_TOKEN: Seu token de autenticação da Twilio
• FROM_NUMBER: Seu número de telefone da Twilio (no formato E.164, ex.: +11234567890)

Configuração do Claude Desktop

Para usar este servidor com o Claude Desktop, adicione o seguinte ao seu arquivo de configuração:

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"
      }
    }
  }
}

Depois disso, reinicie o Claude Desktop para recarregar a configuração. Se conectado, você deve ver a Twilio no menu 🔨.

Exemplos de Interações com o Claude

Aqui estão algumas formas naturais de interagir com o servidor por meio do Claude:

1. SMS simples:

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

2. SMS criativo:

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

Notas Importantes

1. Formato do Número de Telefone: Todos os números de telefone devem estar no formato E.164 (ex.: +11234567890)
2. Limites de Taxa: Esteja ciente dos limites de taxa e preços da sua conta Twilio
3. Segurança: Mantenha suas credenciais da Twilio seguras e nunca as envie para o controle de versão

Solução de Problemas

Mensagens de erro comuns e soluções:

1. "O número de telefone deve estar no formato E.164"

   • Certifique-se de que o número de telefone comece com "+" e o código do país

2. "Credenciais inválidas"

   • Verifique novamente seu ACCOUNT_SID e AUTH_TOKEN. Você pode copiá-los do Console da Twilio

Contribuição

Contribuições são bem-vindas! Leia nossas diretrizes de contribuição antes de enviar pull requests.

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

Segurança

Não inclua informações confidenciais (como números de telefone ou credenciais da Twilio) em issues do GitHub ou pull requests.