Administrador de Twilio MCP

Implementación del Protocolo de Contexto de Modelo (MCP) para la gestión de recursos de Twilio. Este paquete proporciona herramientas para gestionar subcuentas, números de teléfono y paquetes regulatorios de Twilio mediante una interfaz MCP estandarizada.

Características

Lista de subcuentas de Twilio
Obtener números de teléfono asociados a subcuentas
Transferir números de teléfono entre subcuentas
Obtenga SID del paquete regulatorio
Soporte para comunicación directa y eventos enviados por el servidor (SSE)
Integración con Claude Desktop, Cursor y otras herramientas compatibles con MCP

Instalación

Prerrequisitos

Instalar uv

En macOS:

brew install uv

En Windows:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

En Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Configuración del proyecto

Clonar el repositorio:

git clone https://github.com/yourusername/twilio_manager_mcp.git
cd twilio_manager_mcp

Instalar dependencias usando uv:

uv sync

Configuración

Cree un archivo .env en el directorio raíz con sus credenciales de Twilio:

TWILIO_ACCOUNT_SID=your_account_sid
TWILIO_AUTH_TOKEN=your_auth_token

Configure MCP para su herramienta (Cursor, Claude Desktop, etc.) creando un archivo .cursor/mcp.json :

{
  "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"
    }
  }
}

Estibador

Puede ejecutar Twilio Manager MCP usando Docker para facilitar la implementación y la administración.

Uso de Docker Compose

El proyecto incluye una configuración de Docker Compose que configura:

El servicio MCP de Twilio Manager
Un proxy inverso de Traefik con HTTPS automático

Configure las variables de entorno en su archivo .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=

Iniciar los servicios:

docker-compose up -d

La aplicación estará disponible en su dominio configurado con HTTPS habilitado.

Usar Docker sin Docker Compose

Si prefiere ejecutar solo el contenedor MCP de Twilio Manager sin Traefik:

Construya la imagen de Docker:

docker build -t twilio-manager-mcp .

Ejecute el contenedor:

docker run -p 8000:8000 \
  -e TWILIO_ACCOUNT_SID=your_account_sid \
  -e TWILIO_AUTH_TOKEN=your_auth_token \
  twilio-manager-mcp

El punto final SSE estará disponible en http://localhost:8000/sse .

Uso

Con Cursor, Claude Desktop u otras herramientas compatibles con MCP

Tiene tres opciones para utilizar este MCP:

Integración directa con UVX (recomendada):
- Utilice la configuración twilio_manager_mcp_uvx
- Este es el método más simple y funciona de inmediato con uvx.
Integración UV directa :
- Utilice la configuración twilio_manager_mcp_abs
- Requiere especificar la ruta completa a su instalación
Servidor SSE :
- Utilice la configuración twilio_manager_mcp_sse
- Inicie primero el servidor SSE:
  uvicorn twilio_manager_mcp_sse:app --host 0.0.0.0 --port 8000

Herramientas disponibles

Nombre de la herramienta	Descripción
`list_twilio_subaccounts`	Listar todas las subcuentas de Twilio
`get_account_phone_numbers`	Obtener números de teléfono para una subcuenta específica
`get_all_phone_numbers`	Transferir números de teléfono entre subcuentas
`get_regulatory_bundle_sid`	Obtener el SID del paquete regulatorio para una subcuenta

Ejemplo de uso en Cursor/Claude Desktop

Una vez configurado, puedes usar las herramientas directamente en las conversaciones de tu asistente de IA:

Enumere todas las subcuentas:

# The AI will automatically use the MCP to list all subaccounts
# No need to write code - just ask "List all Twilio subaccounts"

Obtener números de teléfono para una subcuenta:

# Simply ask: "Show me all phone numbers for subaccount AC..."

Uso directo de Python

Para uso programático directo:

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..."})

Estructura del proyecto

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

Desarrollo

Para el desarrollo, puede utilizar la gestión del entorno virtual de 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 .

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

Licencia MIT

TwilioManager MCP

Integrations