Twilio MCP Server

Monorepositorio de Twilio MCP

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

¿Qué es MCP?

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

Paquetes

Este monorepositorio contiene dos paquetes principales:

• mcp - Servidor MCP para toda la API pública de Twilio
• openapi-mcp-server - Un servidor MCP que sirve la especificación OpenAPI proporcionada

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

• Documentación del paquete MCP
• Documentación del servidor OpenAPI MCP

Inicio rápido

La forma más fácil de comenzar es usando 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 de API de Twilio para obtener información sobre cómo encontrar/crear tu clave de API y secreto.

Recomendaciones de seguridad

Para protegerse contra ataques de inyección que podrían permitir que sistemas no confiables accedan a tus datos de Twilio, el equipo de ETI aconseja a los usuarios de los servidores Twilio MCP que eviten instalar o ejecutar servidores MCP de la comunidad junto con los oficiales. Hacerlo ayuda a garantizar que solo los servidores MCP de confianza tengan acceso a las herramientas que interactúan con tu cuenta de Twilio, reduciendo el riesgo de acceso no autorizado a los datos.

Opciones básicas de configuración

Ambos paquetes aceptan parámetros de configuración. Aquí tienes un breve resumen:

• Servidor MCP: Usa --services y --tags para filtrar qué APIs exponer
• Servidor OpenAPI MCP: Usa --apiPath para especificar la ubicación de los archivos de especificación OpenAPI

Para obtener detalles completos de configuración, consulta la documentación específica de cada paquete enlazada arriba.

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 los LLM, carga APIs específicas usando --services o --tags
• Problemas de autenticación: Verifica el formato y los permisos de tus credenciales de API de Twilio
• Versionado de API: Comprueba que estás usando la versión correcta de la API (v1, v2, v3) para tus necesidades

Para obtener orientación detallada sobre solución de problemas, consulta la documentación específica del paquete.

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Pull Request.

Licencia

Este proyecto está licenciado bajo la Licencia ISC - consulta el archivo LICENSE para más detalles.