Twilio MCP 服务器

一个模型上下文协议 (MCP) 服务器，使 Claude 和其他 AI 助手能够使用 Twilio 发送 SMS 和 MMS 消息。

演示

功能

• 发送 SMS 消息 📱
• 针对常见消息场景的预构建提示 📝
• 安全处理 Twilio 凭据 🔒

要求

• Node.js >= 18
  • 如果您需要更新 Node.js，我们建议使用 nvm (Node Version Manager)：

    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 的交互示例

以下是一些通过 Claude 与服务器交互的自然方式：

1. 简单 SMS：

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

2. 创意 SMS：

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

重要提示

1. 电话号码格式：所有电话号码必须采用 E.164 格式（例如，+11234567890）
2. 速率限制：请注意您的 Twilio 帐户的速率限制和定价
3. 安全性：确保您的 Twilio 凭据安全，并且永远不要将其提交到版本控制

故障排除

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

1. "Phone number must be in E.164 format"

   • 确保电话号码以 "+" 和国家/地区代码开头

2. "Invalid credentials"

   • 仔细检查您的 ACCOUNT_SID 和 AUTH_TOKEN。您可以从 Twilio 控制台 复制它们

贡献

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

许可证

该项目已获得 MIT 许可证的许可 - 有关详细信息，请参阅 LICENSE 文件。

安全

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