Sms MCP Server

🚀 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 文件。

🔍 演示