Twilio MCP Server

公式

Twilio APIと連携して、メッセージの送信、電話番号の管理、アカウント設定などを行うことができます。

GitHub
107

ドキュメント

Twilio AlphaTwilio Alpha

Twilio MCP モノレポ

これは、すべての Twilio API を公開する Model Context Protocol サーバーのモノレポです。

MCP とは？

Model Context Protocol (MCP) は、AI ツールとサービス間でモデルコンテキスト情報を交換するためのプロトコルです。この実装により、Twilio の API を AI アシスタントや MCP プロトコルをサポートするその他のツールに公開できます。

パッケージ

このモノレポには、2 つの主要なパッケージが含まれています。

  • mcp - すべての Twilio パブリック API 向け MCP サーバー
  • openapi-mcp-server - 指定された OpenAPI 仕様を提供する MCP サーバー

各パッケージには、詳細なドキュメントを含む独自の包括的な README があります。

クイックスタート

最も簡単な開始方法は、npx を使用することです。

{
  "mcpServers": {
    "twilio": {
      "command": "npx",
      "args": [
        "-y",
        "@twilio-alpha/mcp",
        "YOUR_ACCOUNT_SID/YOUR_API_KEY:YOUR_API_SECRET"
      ]
    }
  }
}

API キーとシークレットの検索/作成方法については、Twilio API キーのドキュメント をご覧ください。

セキュリティ推奨事項

信頼できないシステムが Twilio データにアクセスする可能性のあるインジェクション攻撃から保護するために、ETI チームは、Twilio MCP サーバーのユーザーに対し、公式サーバーと一緒にコミュニティ MCP サーバーをインストールまたは実行しないよう推奨しています。これにより、信頼できる MCP サーバーのみが Twilio アカウントとやり取りするツールにアクセスできるようになり、不正なデータアクセスのリスクが軽減されます。

基本的な設定オプション

両方のパッケージとも設定パラメーターを受け入れます。以下に概要を示します。

  • MCP サーバー: --services と --tags を使用して、公開する API をフィルタリングします
  • OpenAPI MCP サーバー: --apiPath を使用して、OpenAPI 仕様ファイルの場所を指定します

完全な設定の詳細については、上記のパッケージ固有のドキュメントを参照してください。

開発

# Run tests
npm test

# Run linting
npm run lint

# Fix linting issues
npm run lint:fix

一般的な問題のトラブルシューティング

  • コンテキストサイズの制限: LLM コンテキストの制限により、--services または --tags を使用して特定の API をロードします
  • 認証の問題: Twilio API 認証情報の形式と権限を確認してください
  • API のバージョン管理: ニーズに合った正しい API バージョン (v1、v2、v3) を使用していることを確認してください

詳細なトラブルシューティングガイダンスについては、パッケージ固有のドキュメントを参照してください。

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは ISC ライセンスの下でライセンスされています。詳細については、LICENSE ファイルを参照してください。