Twilio Messaging MCP Server

🚀 Twilio 消息服務 MCP 服務器

這是一個藉助 Twilio API 發送 SMS 消息的 MCP 服務器。它提供了一系列工具、資源和提示，方便與 Twilio 消息 API 進行交互。

🚀 快速開始

本服務器可通過 Twilio API 發送 SMS 消息，還能獲取狀態回調並進行增強處理，同時集成了 Claude AI，可通過 npx 直接執行，使用便捷。

✨ 主要特性

• 通過 Twilio 發送 SMS 消息。
• 獲取 Twilio 的狀態回調並進行增強處理（使用 @deshartman/mcp-status-callback）。
• 集成 Claude AI，通過模型上下文協議 (MCP) 實現。
• 可通過 npx 執行，無需安裝即可輕鬆使用。

📦 安裝指南

安裝依賴

npm install @deshartman/twilio-messaging-mcp-server

直接運行

若不想安裝，可直接通過 npx 運行：

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

Npx 使用方法

無需安裝，直接使用 npx 執行包：

# 使用所需參數運行
npx @deshartman/twilio-messaging-mcp-server <accountSid> <apiKey> <apiSecret> <number>

# 結合環境變量使用 ngrok
env NGROK_AUTH_TOKEN=your_token NGROK_CUSTOM_DOMAIN=your_domain.ngrok.dev npx @deshartman/twilio-messaging-mcp-server <accountSid> <apiKey> <apiSecret> <number>

這可以實現，因為包的 package.json 中包含 "bin" 字段，使其可通過 npx 執行。

💻 使用示例

運行服務器

你可以使用提供的腳本並通過 .env 文件運行：

# 創建一個 .env 文件，包含你的憑證
# 查看 .env.example 以獲取所需格式

# 啟動服務器（無需參數）
./run-server.sh

.env 文件應包含以下內容：

ACCOUNT_SID=YOUR_ACCOUNT_SID
API_KEY=YOUR_API_KEY
API_SECRET=YOUR_API_SECRET
TWILIO_NUMBER=YOUR_TWILIO_PHONE_NUMBER
NGROK_AUTH_TOKEN=YOUR_NGROK_AUTH_TOKEN
NGROK_CUSTOM_DOMAIN=your-domain.ngrok.dev

這種做法可以提高安全性，避免將憑證暴露在命令歷史中，並簡化執行過程。

直接使用 Node.js

env NGROK_AUTH_TOKEN=your_ngrok_auth_token NGROK_CUSTOM_DOMAIN=your_domain.ngrok.dev node build/index.js <accountSid> <apiKey> <apiSecret> <number>

📚 詳細文檔

先決條件

• Node.js >= 18.0.0
• Twilio 賬戶及以下信息：
  • 賬戶 SID
  • API 密鑰和密鑰
  • Twilio 電話號碼
• ngrok 賬戶及以下信息：
  • 認證令牌
  • 自定義域名（可選）

環境變量

• NGROK_AUTH_TOKEN：你的 ngrok 認證令牌（處理回調時必需）
• NGROK_CUSTOM_DOMAIN：你的自定義 ngrok 域名（可選）

MCP 集成

此服務器提供了以下 MCP 功能：

工具

• send-sms：通過 Twilio 發送 SMS 消息，帶有服務器就緒驗證。

資源

• twilio://statuscallback：獲取 Twilio 的最後一個原始狀態回調數據，並進行增強錯誤處理。

提示

• SendSMS：用於提示發送 SMS 使用 Twilio Messaging MCP 服務器的提示。

故障排除

ngrok 隧道問題

如果你遇到以下錯誤：

failed to start tunnel: The endpoint 'https://your-domain.ngrok.dev' is already online.

你可以嘗試以下方法之一：

1. 先停止現有端點。
2. 使用不同的域名。
3. 啟動兩個端點時使用 --pooling-enabled 進行負載均衡。

ENOTEMPTY 錯誤

如果你遇到 npm 錯誤：

ENOTEMPTY Error: rmdir /path/to/directory

請確保目標目錄為空，或者手動刪除該目錄後重試。這通常是因為 npm 在卸載包時失敗導致的。

總結

這個 MCP 服務器為通過 Twilio 發送 SMS 消息提供了強大的工具和集成能力，支持狀態回調處理，並且可以通過 npx 輕鬆運行。希望以上文檔能幫助你順利完成配置和使用！