TwilioManager MCP
Twilio マネージャー MCP
Twilio リソースを管理するための Model Context Protocol (MCP) 実装。このパッケージは、標準化された MCP インターフェースを通じて、Twilio サブアカウント、電話番号、規制バンドルを管理するためのツールを提供します。
特徴
Twilioサブアカウントの一覧
サブアカウントに関連付けられた電話番号を取得する
サブアカウント間で電話番号を転送する
規制バンドルSIDを取得する
直接通信とサーバー送信イベント(SSE)通信の両方をサポート
Claude Desktop、Cursor、その他のMCP互換ツールとの統合
Related MCP server: Twilio MCP Server
インストール
前提条件
uvをインストールする
macOSの場合:
brew install uvWindowsの場合:
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"Linuxの場合:
curl -LsSf https://astral.sh/uv/install.sh | shプロジェクトのセットアップ
リポジトリをクローンします。
git clone https://github.com/yourusername/twilio_manager_mcp.git
cd twilio_manager_mcpuv を使用して依存関係をインストールします。
uv sync構成
Twilio の資格情報を使用して、ルート ディレクトリに
.envファイルを作成します。
TWILIO_ACCOUNT_SID=your_account_sid
TWILIO_AUTH_TOKEN=your_auth_token.cursor/mcp.jsonファイルを作成して、ツール (Cursor、Claude Desktop など) の MCP を構成します。
{
"mcpServers": {
"twilio_manager_mcp_abs": {
"command": "uv",
"args": ["--directory", "/path/to/twilio_manager_mcp", "run", "mcp", "run", "./twilio_manager_mcp.py"],
"env": {
"TWILIO_ACCOUNT_SID": "your_account_sid",
"TWILIO_AUTH_TOKEN": "your_auth_token"
}
},
"twilio_manager_mcp_uvx": {
"command": "uvx",
"args": [ "twilio-manager-mcp" ],
"env": {
"TWILIO_ACCOUNT_SID": "your_account_sid",
"TWILIO_AUTH_TOKEN": "your_auth_token"
}
},
"twilio_manager_mcp_sse": {
"url": "http://localhost:8000/sse"
}
}
}ドッカー
導入と管理を容易にするために、Docker を使用して Twilio Manager MCP を実行できます。
Docker Composeの使用
このプロジェクトには、以下を設定する Docker Compose 構成が含まれています。
Twilio Manager MCP サービス
自動HTTPSを備えたTraefikリバースプロキシ
.envファイルで環境変数を設定します。
# Twilio credentials
TWILIO_ACCOUNT_SID=your_account_sid
TWILIO_AUTH_TOKEN=your_auth_token
# Domain configuration for Traefik
DOMAIN_NAME=yourdomain.com
ACME_EMAIL=user@yourdomain.com
# Address details (optional)
ADDRESS_CUSTOMER_NAME=
ADDRESS_FRIENDLY_NAME=
ADDRESS_STREET=
ADDRESS_CITY=
ADDRESS_REGION=
ADDRESS_POSTAL_CODE=
ADDRESS_ISO_COUNTRY=サービスを開始します。
docker-compose up -dアプリケーションは、HTTPS が有効になっている構成済みのドメインで利用できるようになります。
Docker Compose なしで Docker を使用する
Traefik を使用せずに Twilio Manager MCP コンテナのみを実行したい場合:
Docker イメージをビルドします。
docker build -t twilio-manager-mcp .コンテナを実行します。
docker run -p 8000:8000 \
-e TWILIO_ACCOUNT_SID=your_account_sid \
-e TWILIO_AUTH_TOKEN=your_auth_token \
twilio-manager-mcpSSE エンドポイントはhttp://localhost:8000/sseで利用できます。
使用法
カーソル、クロードデスクトップ、またはその他のMCP互換ツールを使用
この MCP を使用するには、次の 3 つのオプションがあります。
直接UVX統合(推奨):
twilio_manager_mcp_uvx設定を使用するこれは最も簡単な方法であり、uvxですぐに使用できます。
直接UV統合:
twilio_manager_mcp_abs設定を使用するインストール先のフルパスを指定する必要があります
SSE サーバー:
twilio_manager_mcp_sse設定を使用するまず SSE サーバーを起動します。
uvicorn twilio_manager_mcp_sse:app --host 0.0.0.0 --port 8000
利用可能なツール
ツール名 | 説明 |
| すべてのTwilioサブアカウントを一覧表示する |
| 特定のサブアカウントの電話番号を取得する |
| サブアカウント間で電話番号を転送する |
| サブアカウントの規制バンドル SID を取得する |
Cursor/Claude デスクトップでの使用例
設定が完了すると、AI アシスタントの会話でツールを直接使用できるようになります。
すべてのサブアカウントを一覧表示します:
# The AI will automatically use the MCP to list all subaccounts
# No need to write code - just ask "List all Twilio subaccounts"サブアカウントの電話番号を取得します。
# Simply ask: "Show me all phone numbers for subaccount AC..."Pythonの直接使用
プログラムで直接使用する場合:
from mcp import ClientSession
from clients.client import MCPClient
async with MCPClient("uvx", ["twilio-manager-mcp"], env={}) as session:
# List available tools
tools = (await session.list_tools()).tools
# List all subaccounts
subaccounts = await session.invoke("list_twilio_subaccounts")
# Get phone numbers for a subaccount
numbers = await session.invoke("get_account_phone_numbers", {"account_sid": "AC..."})プロジェクト構造
twilio_manager_mcp/
├── api/
│ └── async_twilio_api.py # Async Twilio API implementation
├── clients/
│ ├── client.py # Direct MCP client implementation
│ └── client_sse.py # SSE client implementation
├── twilio_manager_mcp.py # Core MCP server implementation
├── twilio_manager_mcp_sse.py # SSE server wrapper
├── requirements.txt # Project dependencies
└── README.md # This file発達
開発には、UV の仮想環境管理を使用できます。
# Create a virtual environment
uv venv
# Activate the virtual environment
source .venv/bin/activate # On Unix
.venv\Scripts\activate # On Windows
# Install dependencies in development mode
uv pip install -e .貢献
貢献を歓迎します!お気軽にプルリクエストを送信してください。
ライセンス
MITライセンス
Available Tools
4 toolsget_account_phone_numbersC
Get all phone numbers associated with a Twilio subaccount
Inputs: account_sid (required).
get_all_phone_numbersC
Get all phone numbers associated with a Twilio subaccount
Inputs: source_account_sid (required), phone_number_sid (required), target_account_sid (required).
get_regulatory_bundle_sidC
Get the regulatory bundle SID for a Twilio subaccount
Inputs: subaccount_sid (required).
list_twilio_subaccountsB
List all Twilio subaccounts or filter by friendly name. Provide an empty string for all subaccounts
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Two tools have nearly identical purposes: 'get_account_phone_numbers' and 'get_all_phone_numbers' both retrieve phone numbers for Twilio subaccounts, creating clear ambiguity. The other two tools target distinct resources (regulatory bundles and subaccounts), but the overlap between the first two tools is significant and likely to cause misselection.
All tools follow a consistent verb_noun pattern (e.g., get_account_phone_numbers, list_twilio_subaccounts) with clear, descriptive names. The naming style is uniform across the set, making it easy to parse and understand the actions and targets.
With only 4 tools, the count feels thin for a server named 'TwilioManager MCP', which suggests broader Twilio API management. This limited set may not cover essential operations like sending messages, managing calls, or updating resources, making it borderline for the implied scope.
The tool surface is severely incomplete for Twilio management, lacking core functionalities such as sending SMS, making calls, or updating subaccounts. It focuses narrowly on retrieval operations (get/list) without create, update, or delete capabilities, leading to significant gaps that will hinder agent workflows.
Maintenance
Related MCP Connectors
The Telnyx MCP server is an official implementation of the Model Context Protocol that enables AI clients (like Claude Desktop, Cursor, and OpenAI Agents) to interact with Telnyx's telephony, messaging, and AI assistant APIs. It provides comprehensive capabilities including making and managing phone calls, sending SMS/MMS messages, purchasing and configuring phone numbers, creating AI assistants with custom instructions, managing cloud storage buckets, scraping and embedding website content, and handling integration secrets. The server exists as both a local implementation and a remotely hosted version, allowing developers to integrate real-world communication infrastructure directly into AI applications.
Hosted CallRail MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Lets Claude, Cursor or any MCP client build voice agents and place real phone calls.
Enable secure connectivity between Sentry issues and debugging data, and LLM clients, using a Model Context Protocol (MCP) server.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP (Model Context Protocol) server that lets users send SMS messages through Twilio API directly from Claude Desktop via natural language commands.20 npm5MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables Claude and other AI assistants to send SMS and MMS messages using Twilio.19 npm15MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables AI assistants like Claude to initiate and manage real-time voice calls using Twilio and OpenAI's voice models.64MIT
- AlicenseNot gradedqualityDmaintenanceAn implementation of the Model Context Protocol (MCP) server that exposes Twilio APIs to AI assistants and tools, allowing them to interact with Twilio services through the MCP protocol.114MIT