-
securityF
license-
qualityAn MCP server that enables communication with users through Telegram. This server provides a tool to ask questions to users and receive their responses via a Telegram bot.
Last updated -
1
16
JavaScript
Conecte modelos de lenguaje grandes a Telegram a través del Protocolo de contexto de modelo (MCP) .
Creado con Telethon , este servidor permite a los agentes de IA interactuar con Telegram, habilitando funciones como enviar/editar/eliminar mensajes, buscar chats, administrar borradores, descargar medios y más mediante MTProto .
🚀 Primeros pasos
Prerrequisitos
- Python 3.10 o superior
- Instalar
uva través de la guía oficial de uv .
Instalación
Instalar la herramienta CLI mcp-telegram :
⚙️ Uso
[!IMPORTANTE] Asegúrate de leer y comprender las Condiciones de Servicio de Telegram antes de usar esta herramienta. El uso indebido de esta herramienta puede resultar en restricciones de cuenta.
La herramienta de línea de comandos mcp-telegram es su punto de entrada.
Acceso
Primero, autentícate con tu cuenta de Telegram:
Este comando interactivo le solicitará lo siguiente:
- ID de API y hash de API: obténgalos en my.telegram.org/apps .
- Número de teléfono: su número de teléfono registrado en Telegram (formato internacional, por ejemplo,
+1234567890). - Código de verificación: enviado a su cuenta de Telegram en el primer inicio de sesión.
- Contraseña 2FA: si tiene habilitada la autenticación de dos factores.
Sus credenciales se almacenan de forma segura en el archivo de sesión para uso futuro.
[!ADVERTENCIA] Mantenga sus credenciales de API privadas y nunca las comparta públicamente
[!NOTA] Utilice
mcp-telegram logoutpara cerrar la sesión actual omcp-telegram clear-sessionpara eliminar todos los datos de sesión almacenados.
Conectarse al servidor MCP
Para usar Telegram MCP con clientes MCP como Claude Desktop o Cursor, deberá configurar el servidor MCP. El proceso de configuración varía según el cliente y el sistema operativo.
Para obtener instrucciones de configuración detalladas, consulte:
El archivo de configuración debe contener:
[!Nota] Las rutas de configuración varían según el sistema operativo y el cliente. Por ejemplo:
- macOS:
~/Library/Application Support/Claude/o~/.cursor/- Windows:
%APPDATA%\Claude\o%APPDATA%\Cursor\
[!IMPORTANTE] Si su cliente no puede ejecutar
mcp-telegrama pesar de estar accesible en la terminal, intente usar la ruta completa del ejecutable. Puede averiguarlo ejecutandowhich mcp-telegram(macOS/Linux) owhere mcp-telegram(Windows) en su terminal. Reemplace el valorcommanden la configuración con la ruta completa.
Después de guardar el archivo de configuración, reinicie su aplicación.
🧰 Herramientas disponibles
Aquí tienes una lista completa de herramientas que puedes usar para interactuar con Telegram a través de MCP:
📨 Herramientas de mensajería
| Herramienta | Descripción |
|---|---|
send_message | ✉️ Envía mensajes de texto o archivos a cualquier usuario, grupo o canal |
edit_message | ✏️ Modificar el contenido de mensajes enviados previamente |
delete_message | 🗑️ Eliminar uno o varios mensajes |
get_messages | 📜 Recupera el historial de mensajes con opciones de filtrado avanzadas |
🔍 Búsqueda y navegación
| Herramienta | Descripción |
|---|---|
search_dialogs | 🔎 Encuentra usuarios, grupos y canales por nombre o nombre de usuario |
message_from_link | 🔗 Accede a mensajes específicos mediante enlaces de Telegram |
📝 Gestión de Borradores
| Herramienta | Descripción |
|---|---|
get_draft | 📋 Ver el borrador del mensaje actual de cualquier chat |
set_draft | ✍️ Crear o borrar borradores de mensajes |
📂 Manejo de medios
| Herramienta | Descripción |
|---|---|
media_download | 📸 Descargar fotos, vídeos y documentos desde mensajes |
[!Nota] Para obtener información detallada de los parámetros y casos de uso de ejemplo, ejecute
mcp-telegram toolsen su terminal.
🛠️ Solución de problemas
Errores de bloqueo de la base de datos
Ejecutar varias instancias mcp-telegram con el mismo archivo de sesión puede provocar errores database is locked debido al almacenamiento de sesiones SQLite de Telethon. Asegúrese de que solo una instancia use un archivo de sesión a la vez.
Si necesita detener procesos potencialmente bloqueados:
- macOS/Linux:
pkill -f "mcp-telegram" - Windows:
taskkill /F /IM mcp-telegram.exe /T(Consulte el Administrador de tareas para conocer el nombre exacto del proceso)
🤝 Contribuyendo
¡Agradecemos las contribuciones! Si quieres ayudar a mejorar MCP Telegram, no dudes en enviarnos incidencias, solicitudes de funciones o solicitudes de incorporación de cambios. Tus comentarios y contribuciones ayudan a mejorar este proyecto para todos.
📝 Licencia
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Servidor MCP para Telegram
Related MCP Servers
- -securityAlicense-qualityA server that enables interaction with Telegram chats directly through MCP-compatible hosts like Claude for Desktop, providing tools to retrieve chats, get messages, and send messages.Last updated -134PythonApache 2.0
- -securityAlicense-qualityA simple MCP server that allows Claude to access your Telegram account to read and send messages on your behalf.Last updated -4PythonApache 2.0
- Python