Twilio MCP Monorepo

Twilio MCP モノレポ

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

MCP とは？

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

パッケージ

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

• mcp - Twilio のすべての公開 API に対応する MCP サーバー
• openapi-mcp-server - 指定された OpenAPI 仕様を提供する MCP サーバー

各パッケージには、詳しいドキュメントを記載した独自の README があります。

• MCP パッケージのドキュメント
• OpenAPI MCP サーバーのドキュメント

クイックスタート

最も簡単に始めるには、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 サーバー：公開する API を絞り込むには、--services と --tags を使用します
• OpenAPI MCP サーバー：OpenAPI 仕様ファイルの場所を指定するには、--apiPath を使用します

設定の詳細については、上記の各パッケージのドキュメントをご覧ください。

開発

# 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 ファイルをご覧ください。