Este es un monorepositorio para el servidor del Protocolo de Contexto de Modelo que expone todas las API de Twilio.

¿Qué es MCP?

El Protocolo de Contexto de Modelo (MCP) es un protocolo para el intercambio de información de contexto de modelo entre herramientas y servicios de IA. Esta implementación permite exponer las API de Twilio a asistentes de IA y otras herramientas compatibles con el protocolo MCP.

Related MCP server: Aligo SMS MCP Server

Paquetes

Este monorepositorio contiene dos paquetes principales:

mcp - Servidor MCP para todas las API públicas de Twilio
openapi-mcp-server : un servidor MCP que sirve la especificación OpenAPI dada

Cada paquete tiene su propio README completo con documentación detallada:

Inicio rápido

La forma más fácil de comenzar es utilizando npx:

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

Visita la documentación de claves API de Twilio para obtener información sobre cómo encontrar/crear tu clave API y secreto.

Recomendaciones de seguridad

Para protegerse contra ataques de inyección que permitan a sistemas no confiables acceder a sus datos de Twilio, el equipo de ETI recomienda a los usuarios de servidores MCP de Twilio que eviten instalar o ejecutar servidores MCP comunitarios junto con los oficiales. Esto garantiza que solo los servidores MCP confiables tengan acceso a las herramientas que interactúan con su cuenta de Twilio, lo que reduce el riesgo de acceso no autorizado a los datos.

Opciones de configuración básicas

Ambos paquetes aceptan parámetros de configuración. A continuación, un breve resumen:

Servidor MCP : use --services y --tags para filtrar qué API exponer
Servidor MCP de OpenAPI : utilice --apiPath para especificar la ubicación de los archivos de especificaciones de OpenAPI

Para obtener detalles de configuración completos, consulte la documentación específica del paquete vinculada anteriormente.

Desarrollo

# Run tests npm test # Run linting npm run lint # Fix linting issues npm run lint:fix

Solución de problemas comunes

Limitaciones de tamaño de contexto : debido a los límites de contexto de LLM, cargue API específicas usando --services o --tags
Problemas de autenticación : Verifique el formato y los permisos de las credenciales de la API de Twilio
Control de versiones de API : comprueba que estás utilizando la versión de API correcta (v1, v2, v3) para tus necesidades

Para obtener una guía detallada sobre solución de problemas, consulte la documentación específica del paquete.