Twilio Messaging MCP Server

Twilio Messaging MCP サーバー

Twilio API 経由で SMS メッセージを送信するための MCP サーバーです。このサーバーは、Twilio Messaging API とやり取りするためのツール、リソース、プロンプトを提供します。

特長

• Twilio 経由で SMS メッセージを送信
• @deshartman/mcp-status-callback による拡張処理で、Twilio からステータスコールバックを取得
• Model Context Protocol（MCP）経由で Claude AI と連携
• インストール不要で簡単に利用できるよう、npx から実行可能

前提条件

• Node.js >= 18.0.0
• 以下を備えた Twilio アカウント：
  • アカウント SID
  • API キーとシークレット
  • Twilio の電話番号
• 以下を備えた ngrok アカウント：
  • 認証トークン
  • カスタムドメイン（任意）

インストール

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

または、npx で直接実行します：

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

NPX の使用方法

このパッケージは、インストールせずに npx を使って直接実行できます：

# Run with required parameters
npx @deshartman/twilio-messaging-mcp-server <accountSid> <apiKey> <apiSecret> <number>

# With environment variables for 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 経由で実行できます。

環境変数

• NGROK_AUTH_TOKEN：ngrok の認証トークン（コールバック処理に必須）
• NGROK_CUSTOM_DOMAIN：カスタム ngrok ドメイン（任意）

使用方法

サーバーの実行

.env ファイルを使って、付属のスクリプトでサーバーを実行できます：

# Create a .env file with your credentials
# See .env.example for the required format

# Run the server (no arguments needed)
./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>

MCP 連携

このサーバーは、次の MCP 機能を提供します：

ツール

• send-sms：サーバーの準備状況を検証したうえで、Twilio 経由で SMS メッセージを送信

リソース

• twilio://statuscallback：エラー処理を強化して、Twilio からの最後の未加工のステータスコールバックデータを取得

プロンプト

• SendSMS：Twilio Messaging MCP Server を使って SMS を送信するためのプロンプト

トラブルシューティング

ngrok トンネルの問題

次のようなエラーが発生した場合：

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

次のいずれかを試してください：

1. 既存のエンドポイントを先に停止する
2. 別のドメイン名を使う
3. 両方のエンドポイントを --pooling-enabled 付きで起動して、負荷を分散する

ENOTEMPTY エラー

次のような npm エラーが発生した場合：

npm ERR! code ENOTEMPTY
npm ERR! syscall rename

npx を使わず、Node.js でサーバーを直接実行してみてください。

ライセンス

MIT