Serveur MCP SMS
en Python

Envoyez des SMS depuis Claude Desktop, Cursor ou Windsurf avec le SDK MCP officiel Python.

Notre serveur MCP Python permet à vos agents IA d'envoyer des SMS professionnels via SMS Vert Pro. Il utilise le SDK MCP officiel d'Anthropic (FastMCP) et la bibliothèque httpx pour des appels API sécurisés et performants.

Ce serveur est idéal pour les développeurs qui travaillent dans l'écosystème Python et qui utilisent déjà des frameworks comme LangChain, CrewAI ou AutoGen pour leurs agents IA. L'installation se fait en deux commandes.

Pourquoi choisir la version Python ?

SDK MCP officiel : utilise le package mcp maintenu par Anthropic, garantissant la compatibilité avec les évolutions du protocole
Validation renforcée : chaque entrée est validée (format des numéros, longueur du message, expéditeur, code OTP) avant l'appel API
SSL vérifié : toutes les communications avec l'API sont chiffrées et le certificat est vérifié systématiquement
Écosystème Python IA : s'intègre naturellement si vous développez déjà vos agents en Python

Installation

git clone https://github.com/3-bees-online/mcp-server-smsvertpro-python.git
cd mcp-server-smsvertpro-python
pip install -r requirements.txt

Les dépendances sont minimales : mcp (SDK officiel) et httpx (client HTTP moderne). Python 3.10 ou supérieur est requis.

Configuration dans Claude Desktop

Ouvrez votre fichier claude_desktop_config.json et ajoutez :

{
  "mcpServers": {
    "smsvertpro": {
      "command": "python",
      "args": ["/chemin/vers/server.py"],
      "env": {
        "SMSVERTPRO_API_TOKEN": "votre_token_api"
      }
    }
  }
}

Le token API Bearer se génère depuis votre espace client SMS Vert Pro.

Claude Code (CLI)

claude mcp add smsvertpro -- python /chemin/vers/server.py

Cursor / Windsurf

Ajoutez la configuration MCP dans les paramètres de votre éditeur en pointant vers python server.py avec la variable d'environnement SMSVERTPRO_API_TOKEN.

Les 8 outils SMS disponibles

Votre agent IA dispose automatiquement de tous ces outils :

Outil	Description	Exemple de demande à l'agent
`send_sms`	Envoyer un SMS immédiat ou programmé	« Envoie un SMS au 33612345678 pour annoncer la promo -20% »
`check_credits`	Consulter le solde de crédits	« Combien de crédits SMS il me reste ? »
`get_delivery_report`	Rapport de délivrabilité	« Le SMS de la campagne 4521 a été reçu ? »
`get_responses`	Réponses SMS reçues	« Des réponses sur ma campagne 4521 ? »
`verify_number`	Vérifier le format des numéros	« Vérifie les numéros de ma liste 87 »
`get_blacklist`	Liste des désabonnements (STOP)	« Quels numéros se sont désabonnés ? »
`generate_otp`	Envoyer un code OTP	« Envoie un code de vérification au 33698765432 »
`verify_otp`	Vérifier un code OTP	« Le code 5837 est-il valide ? »
`cancel_sms`	Annuler un SMS programmé	« Annule la campagne camp_334_1234 »

Validation et sécurité

La version Python intègre une validation complète des données avant chaque appel API :

Donnée	Validation
Numéro de téléphone	10-15 chiffres, format international, nettoyage automatique du `+`
Expéditeur	Alphanumérique, 11 caractères maximum
Message	Non vide, 918 caractères maximum (6 SMS concaténés)
Code OTP	4-8 chiffres uniquement
Date différée	Format strict `YYYY-MM-DD HH:MM`

Token sécurisé : votre clé API reste locale, jamais transmise à l'agent IA
HTTPS vérifié : certificat SSL validé sur chaque appel à l'API SMS Vert Pro
Aucune donnée stockée : le serveur ne conserve aucun message ni numéro

Télécharger sur GitHub

Une question ?
Besoin d'aide pour l'installation ?

01 60 04 51 65

Open source (MIT) 10 SMS Offerts Sans engagement

Créer un compte

Questions fréquentes

Python 3.10 ou supérieur. Le serveur utilise les annotations de type modernes (list[str]) introduites en Python 3.10. Vérifiez votre version avec python --version.

Les trois versions offrent les mêmes 9 outils SMS. La version Python utilise le SDK MCP officiel d'Anthropic avec validation renforcée, la version TypeScript/Node.js s'installe en une commande via npm (npx @3-bees-online/mcp-server-smsvertpro), et la version PHP est sans dépendance (un seul fichier). Choisissez selon votre environnement.

Le serveur MCP est conçu pour les clients MCP (Claude Desktop, Cursor, Windsurf). Pour LangChain ou CrewAI, vous pouvez appeler directement notre API REST comme outil personnalisé — consultez notre guide d'intégration IA pour des exemples de code Python.

Oui. Si votre compte est configuré en route marketing, vous devez ajouter la mention STOP 36173 à la fin de chaque message promotionnel. C'est une obligation légale. L'API ne l'ajoute pas automatiquement — pensez à l'inclure dans le texte de votre SMS ou à l'indiquer à votre agent IA.

À découvrir également

Pour les développeurs JavaScript et TypeScript, notre serveur MCP est aussi disponible via npm en une commande : npx @3-bees-online/mcp-server-smsvertpro. Le code source est sur GitHub.

Si vous préférez PHP ou si vous n'avez pas Python installé, notre serveur MCP en PHP offre les mêmes fonctionnalités en un seul fichier, sans aucune dépendance.

Pour un usage sans installation, notre serveur MCP SMS hébergé expose directement un endpoint HTTPS accessible depuis Claude.ai, ChatGPT ou n'importe quel client MCP remote.

Pour une vue d'ensemble des méthodes d'intégration (API directe, MCP, exemples de code), consultez notre guide complet d'intégration IA.

Pour la documentation technique de tous les endpoints, consultez notre documentation API SMS.

Ils nous font
confiance