Twilio MCP Server

Twilio MCP 服务

一个 Model Context Protocol（MCP）服务，可让 Claude 和其他 AI 助手使用 Twilio 发送 SMS 和 MMS 消息。

演示

功能

• 发送 SMS 消息 📱
• 为常见消息场景预设提示词 📝
• 安全处理 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 的交互示例

以下是通过 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. “电话号码必须采用 E.164 格式”

   • 确保电话号码以“+”和国家代码开头

2. “凭据无效”

   • 仔细检查 ACCOUNT_SID 和 AUTH_TOKEN。你可以从 Twilio Console 复制这些信息

贡献

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

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

安全性

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