Twilio MCP Server

Monorepo Twilio MCP

Ceci est un monorepo pour le serveur Model Context Protocol qui expose toutes les API Twilio.

Qu'est-ce que MCP ?

Le Model Context Protocol (MCP) est un protocole d'échange d'informations de contexte de modèle entre les outils et services d'IA. Cette implémentation vous permet d'exposer les API de Twilio aux assistants IA et autres outils prenant en charge le protocole MCP.

Paquets

Ce monorepo contient deux paquets principaux :

• mcp - Serveur MCP pour toute l'API publique de Twilio
• openapi-mcp-server - Un serveur MCP qui sert la spécification OpenAPI donnée

Chaque paquet possède son propre fichier README complet avec une documentation détaillée :

• Documentation du paquet MCP
• Documentation du serveur OpenAPI MCP

Démarrage rapide

Le moyen le plus simple de commencer est d'utiliser npx :

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

Consultez la documentation des clés API Twilio pour savoir comment trouver/créer votre clé API et votre secret.

Recommandations de sécurité

Pour se prémunir contre les attaques par injection qui pourraient permettre à des systèmes non fiables d'accéder à vos données Twilio, l'équipe ETI conseille aux utilisateurs des serveurs Twilio MCP d'éviter d'installer ou d'exécuter des serveurs MCP communautaires aux côtés de nos serveurs officiels. Cela permet de garantir que seuls les serveurs MCP de confiance ont accès aux outils interagissant avec votre compte Twilio, réduisant ainsi le risque d'accès non autorisé aux données.

Options de configuration de base

Les deux paquets acceptent des paramètres de configuration. Voici un bref aperçu :

• Serveur MCP : Utilisez --services et --tags pour filtrer les API à exposer
• Serveur OpenAPI MCP : Utilisez --apiPath pour spécifier l'emplacement des fichiers de spécification OpenAPI

Pour des détails de configuration complets, reportez-vous à la documentation spécifique au paquet mentionnée ci-dessus.

Développement

# Run tests
npm test

# Run linting
npm run lint

# Fix linting issues
npm run lint:fix

Dépannage des problèmes courants

• Limitations de taille de contexte : En raison des limites de contexte des LLM, chargez des API spécifiques en utilisant --services ou --tags
• Problèmes d'authentification : Vérifiez le format et les autorisations de vos identifiants API Twilio
• Gestion des versions d'API : Vérifiez que vous utilisez la version d'API correcte (v1, v2, v3) pour vos besoins

Pour des conseils de dépannage détaillés, consultez la documentation spécifique au paquet.

Contribution

Les contributions sont les bienvenues ! N'hésitez pas à soumettre une Pull Request.

Licence

Ce projet est sous licence ISC - voir le fichier LICENSE pour plus de détails.