🚀 Twilio MCP 服务器

Twilio MCP 服务器是一个模型上下文协议（MCP）服务器，它能让 Claude 和其他 AI 助手借助 Twilio 来发送短信和彩信，为信息交互提供了便捷的解决方案。

🚀 快速开始

在使用该服务器前，需要完成相关的需求配置和环境变量设置，具体步骤如下文所述。

✨ 主要特性

• 📱 发送短信消息：支持通过服务器发送短信。
• 📝 常见.messaging 场景的预建提示：提供常见场景的预建提示，方便使用。
• 🔒 安全处理 Twilio 凭证：保障 Twilio 凭证的安全。

📦 安装指南

环境要求

• Node.js >= 18
  • 如果需要更新 Node.js，推荐使用nvm（Node 版本管理器），可在终端运行以下命令：

    nvm install 18.14.2
    nvm alias default 18.14.2
    

  • 如果在 Claude Desktop 中遇到任何错误，请尝试在终端运行以下命令以验证安装：

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

环境变量配置

服务器需要三个环境变量：

• ACCOUNT_SID：您的 Twilio 账户 SID
• AUTH_TOKEN：您的 Twilio 身份令牌
• FROM_NUMBER：您的 Twilio 电话号码（E.164 格式，例如 +11234567890）

Claude Desktop 配置

要将此服务器与 Claude Desktop 一起使用，请在配置文件中添加以下内容：

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

完成配置后，重启 Claude Desktop 以重新加载配置。如果连接成功，您应该在 🔨 菜单下看到 Twilio。

💻 使用示例

基础用法

以下是通过 Claude 自然交互服务器的一些示例：

1. 简单短信：

向号码+11234567890发送一条消息：“别忘了今晚的晚餐！”

2. 创意短信：

写一首关于秋天的俳句并发送到我的号码+11234567890

📚 详细文档

重要注意事项

⚠️ 重要提示

1. 所有电话号码必须是 E.164 格式（例如，+11234567890）。
2. 注意 Twilio 账户的速率限制和定价。
3. 保持 Twilio 凭证的安全性，绝不在版本控制中提交。

故障排除

常见错误消息及解决方案：

1. “电话号码必须是 E.164 格式”
   • 确保电话号码以“+”开头并包含国家代码。
2. “无效凭证”
   • 检查ACCOUNT_SID和AUTH_TOKEN。您可以在Twilio 控制台复制它们。

贡献

欢迎贡献！请在提交拉取请求之前阅读我们的贡献指南。

安全性

⚠️ 重要提示

请勿在 GitHub 问题或拉取请求中包含任何敏感信息（如电话号码或 Twilio 凭证）。

📄 许可证

此项目根据 MIT 许可证发布 - 有关详细信息，请参阅 LICENSE 文件。

🔍 演示