Deshartman Twilio Messaging MCP Server

🚀 Twilio 消息服務 MCP 服務器

這是一個使用 Twilio API 發送 SMS 消息的 MCP（模型上下文協議）服務器，能有效解決消息發送問題，為用戶提供便捷、安全的消息發送服務。

🚀 快速開始

此服務器可藉助 Twilio API 發送 SMS 消息，還能與 Claude Desktop 等 MCP 客戶端集成，並且安全處理憑證，無需使用環境變量，同時利用 Twilio API Keys 提升安全性。

✨ 主要特性

• 通過 Twilio API 發送 SMS 消息。
• 集成與 Claude Desktop 等 MCP 客戶端。
• 安全處理憑證，無需使用環境變量。
• 使用 Twilio API Keys 提高安全性。

📦 安裝指南

可以直接使用 npx 運行：

npx twilio-messaging-mcp-server <accountSid> <apiKey> <apiSecret> <number>

或者全局安裝：

npm install -g twilio-messaging-mcp-server
twilio-messaging-mcp-server <accountSid> <apiKey> <apiSecret> <number>

📚 詳細文檔

配置

服務器需要以下參數：

安全注意事項

⚠️ 重要提示

此服務器使用 API Keys 和 Secret 而不是 Auth Tokens 提高安全性。這種做法提供更好的訪問控制，並且可以在需要時 revoke 憑證。有關詳細信息，請參閱 Twilio API Keys 文檔。

與 Claude Desktop 的使用

本地開發

對於本地開發（當包未發佈到 npm 時），將以下內容添加到你的 Claude Desktop 配置文件 (~/Library/Application Support/Claude/claude_desktop_config.json on macOS 或 %APPDATA%\Claude\claude_desktop_config.json on Windows)：

{
  "mcpServers": {
    "twilio-messaging": {
      "command": "node",
      "args": [
        "/PATHTONODE/twilio-messaging-mcp-server/build/index.js",
        "your_account_sid_here",
        "your_api_key_here",
        "your_api_secret_here",
        "+1234567890"
      ]
    }
  }
}

將值替換為你的實際 Twilio 憑證：

• 第一個參數：你的 Twilio 賬戶 SID（以 "AC" 開頭）
• 第二個參數：你的 Twilio API Key（以 "SK" 開頭）
• 第三個參數：你的 Twilio API Secret
• 第四個參數：你的 Twilio 電話號碼，E.164 格式

你可以通過以下命令獲取絕對路徑：

# 在 macOS/Linux 上
echo "$(pwd)/build/index.js"

# 在 Windows（PowerShell 上）
Write-Output "$((Get-Location).Path)\build\index.js"

發佈到 npm 後

一旦包發佈到 npm，你可以使用以下配置：

{
  "mcpServers": {
    "twilio-messaging": {
      "command": "node",
      "args": [
        "twilio-messaging-mcp-server/build/index.js",
        "your_account_sid_here",
        "your_api_key_here",
        "your_api_secret_here",
        "+1234567890"
      ]
    }
  }
}

可用工具

• send-sms：通過 Twilio API 發送 SMS 消息的工具。
  • 參數：
    • --accountSid：你的 Twilio 賬戶 SID。
    • --apiKey：你的 Twilio API Key。
    • --apiSecret：你的 Twilio API Secret。
    • --to：接收消息的電話號碼。
    • --message：要發送的消息。

💻 使用示例

基礎用法

node build/index.js <accountSid> <apiKey> <apiSecret> <number>

高級用法

node build/index.js AC123456789 SK0123456789 abcdefghijklmn +1234567890

🔧 技術細節

安裝依賴項

npm install

運行測試服務器

node build/index.js <accountSid> <apiKey> <apiSecret> <number>

📄 許可證

[在此處添加許可證信息]