Serveur MCP Telegram

Que fait le serveur MCP “Telegram” ?

Le serveur MCP Telegram intègre les puissantes capacités de la plateforme de messagerie Telegram avec le Model Context Protocol (MCP), permettant aux assistants IA et aux clients d’interagir de façon programmatique avec Telegram. Grâce à la bibliothèque Telethon, ce serveur permet l’automatisation complète et la gestion des discussions, messages, groupes et interactions utilisateurs dans Telegram. Il agit comme un pont entre les agents IA et l’API Telegram, rendant possibles des tâches telles que l’envoi de messages, la récupération d’historiques, la gestion de groupes, et bien plus encore. Cela améliore considérablement les flux de développement en fluidifiant la communication, en facilitant les réponses automatisées et en offrant des outils pour interroger ou modifier les données Telegram directement depuis des outils alimentés par l’IA comme Claude, Cursor et d’autres clients compatibles MCP.

Liste des prompts

Aucun modèle de prompt n’a été listé dans la documentation ou les fichiers du dépôt disponibles.

Liste des ressources

Aucune primitive de ressource MCP explicite n’a été documentée ou listée dans les fichiers ou le README disponibles.

Liste des outils

• get_chats(page, page_size) : Retourne une liste paginée des discussions et groupes Telegram accessibles à l’utilisateur authentifié. Cela permet aux clients et LLM de parcourir et sélectionner les conversations de l’utilisateur pour analyse ou messagerie.

La documentation indique que « Chaque fonctionnalité majeure de Telegram/Telethon est disponible en tant qu’outil », mais seul get_chats est mentionné explicitement. La liste complète des outils n’est pas fournie dans la documentation visible.

Cas d’usage de ce serveur MCP

• Messagerie automatisée : Les agents IA peuvent envoyer des messages, médias ou fichiers à des individus ou des groupes sur Telegram, permettant des notifications, réponses ou diffusions automatisées.
• Analyse de discussion : Récupérez et analysez les historiques de discussion pour résumer les échanges, extraire des actions ou réaliser une analyse de sentiment dans des groupes Telegram ou des conversations privées.
• Gestion de groupes : Gérez de façon programmatique les membres, rôles et permissions pour une administration fluide de communauté ou d’équipe.
• Intégration de bots : Utilisez le serveur pour exploiter des bots Telegram capables d’exécuter des flux complexes, de relayer des informations ou de servir d’assistants virtuels IA.
• Récupération de données transparente : Extrayez des messages, fichiers ou détails de discussions pour une intégration dans des systèmes externes, tableaux de bord ou bases de données, en support à l’automatisation avancée.

Comment le configurer

Windsurf

1. Prérequis : Assurez-vous que Node.js est installé et que Windsurf est configuré.
2. Localiser la configuration : Ouvrez vos paramètres ou fichier de configuration Windsurf.
3. Ajouter le serveur MCP : Insérez le serveur MCP Telegram dans la section mcpServers :

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. Enregistrez et redémarrez : Sauvegardez la configuration et redémarrez Windsurf.
5. Vérifiez la configuration : Contrôlez le tableau de bord Windsurf ou les journaux pour vérifier que telegram-mcp fonctionne.

Sécurisation des clés API (exemple)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

Claude

1. Prérequis : Assurez-vous que Claude Desktop ou un client compatible Claude est installé.
2. Localiser la configuration : Modifiez le fichier claude_desktop_config.json.
3. Ajouter l’entrée serveur MCP :

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. Enregistrez et redémarrez : Sauvegardez le fichier JSON et redémarrez Claude.
5. Vérifiez : Confirmez que Claude détecte et se connecte à telegram-mcp.

Sécurisation des clés API (exemple)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

Cursor

1. Prérequis : Installez Node.js et l’éditeur Cursor.
2. Ouvrir les paramètres Cursor : Accédez à la section d’intégration MCP.
3. Ajouter le serveur MCP Telegram :

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. Redémarrez Cursor : Sauvegardez les paramètres et redémarrez l’application Cursor.
5. Vérifiez : Confirmez que Cursor reconnaît et se connecte au serveur MCP Telegram.

Sécurisation des clés API (exemple)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

Cline

1. Prérequis : Assurez-vous que Cline est installé et configuré.
2. Ouvrir le fichier de configuration : Modifiez vos paramètres ou fichier de configuration Cline.
3. Insérer l’entrée serveur MCP :

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. Enregistrez & redémarrez : Sauvegardez le fichier, redémarrez Cline.
5. Vérifiez : Contrôlez l’interface Cline pour vérifier la présence du serveur MCP Telegram.

Sécurisation des clés API (exemple)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

Comment utiliser ce MCP dans les flux

Utiliser le MCP dans FlowHunt

Pour intégrer des serveurs MCP à votre flux FlowHunt, commencez par ajouter le composant MCP à votre flux et reliez-le à votre agent IA :

Cliquez sur le composant MCP pour ouvrir le panneau de configuration. Dans la section configuration MCP système, insérez les détails de votre serveur MCP avec ce format JSON :

{
  "telegram-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Une fois la configuration terminée, l’agent IA pourra utiliser ce MCP comme outil avec accès à toutes ses fonctions et capacités. N’oubliez pas de remplacer “telegram-mcp” par le nom réel de votre serveur MCP et l’URL par celle de votre propre serveur MCP.

Aperçu

Prise en charge des roots : Pas de mention explicite
Prise en charge du sampling : Pas de mention explicite

J’évaluerais le serveur MCP Telegram à 6/10. Il est fonctionnellement robuste avec des instructions de configuration et de sécurité claires, mais il manque de documentation sur les modèles de prompts, les ressources explicites et une liste exhaustive d’outils, éléments importants pour une intégration MCP avancée et une meilleure transparence.

Score MCP