Twilio Messaging MCP Server

🚀 Twilio メッセージングサービス MCP サーバー

このサーバーは、Twilio API を介して SMS メッセージを送信するための MCP サーバーです。Twilio メッセージ API とのやり取りに必要なツール、リソース、ヒントを提供します。

✨ 主な機能

• Twilio を通じて SMS メッセージを送信します。
• Twilio のステータスコールバックを取得し、@deshartman/mcp-status-callback を使用して拡張処理を行います。
• モデルコンテキストプロトコル (MCP) を介して Claude AI を統合します。
• 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" フィールドが含まれているため可能です。

📚 ドキュメント

前提条件

• Node.js >= 18.0.0
• Twilio アカウントと以下の情報
  • アカウント SID
  • API キーとシークレット
  • Twilio 電話番号
• ngrok アカウントと以下の情報
  • 認証トークン
  • カスタムドメイン（オプション）

環境変数

• NGROK_AUTH_TOKEN：ngrok の認証トークン（コールバックを処理する際に必須）
• NGROK_CUSTOM_DOMAIN：カスタム ngrok ドメイン（オプション）

使用方法

サーバーの起動

提供されたスクリプトを使用し、.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>

MCP 統合

このサーバーは以下の MCP 機能を提供します。

ツール

• send-sms：サーバーの準備状態を検証し、Twilio を通じて SMS メッセージを送信します。

リソース

• twilio://statuscallback：Twilio の最後の生のステータスコールバックデータを取得し、拡張エラー処理を行います。

ヒント

• SendSMS：Twilio Messaging MCP サーバーを使用して SMS を送信するためのヒントです。

トラブルシューティング

ngrok トンネルの問題

以下のエラーが発生した場合：

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

以下のいずれかの方法を試してみてください。

1. 既存のエンドポイントを停止します。
2. 別のドメインを使用します。
3. 2 つのエンドポイントを起動する際に --pooling-enabled を使用して負荷分散を行います。

ENOTEMPTY エラー

npm エラーが発生した場合：

ENOTEMPTY Error: rmdir /path/to/directory

対象のディレクトリが空であることを確認するか、手動でディレクトリを削除してから再度試してください。これは通常、npm がパッケージをアンインストールする際に失敗したために発生します。

まとめ

この MCP サーバーは、Twilio を通じて SMS メッセージを送信するための強力なツールと統合機能を提供し、ステータスコールバックの処理をサポートし、npx で簡単に実行できます。上記のドキュメントが設定と使用をスムーズに行うのに役立つことを願っています！