Cherry Studio es un cliente de IA de escritorio multiplataforma que se conecta con numerosos proveedores de LLM, modelos locales y más de 300 asistentes preconfigurados.
chigwell/telegram-mcp
Servidor MCP basado en Telethon que permite a clientes de IA como Claude y Cursor leer chats de Telegram y gestionar grupos, mensajes, archivos multimedia y contactos.
- Estrellas
- 1,850
- Forks
- 470
- Issues abiertos
- 31
- Último commit
- hace 23 horas
¿Qué es?
Telegram MCP Server es una integración que ofrece operaciones de cuentas de Telegram, chats, mensajes, contactos, archivos multimedia, carpetas y administración a clientes compatibles con MCP, como Claude Desktop y Cursor. Está basado en Telethon y ofrece más de 80 herramientas para gestionar chats y grupos, mensajes (enviar, editar, reenviar, buscar, encuestas y reacciones), contactos, archivos multimedia, ajustes del perfil y de privacidad, y carpetas de Telegram.
El servidor admite varias cuentas, a las que se dirige mediante etiquetas, y puede limitarse a un conjunto de herramientas de solo lectura o a una lista de chats permitidos. Puede ejecutarse mediante stdio, HTTP transmisible o SSE, e incluye transcripción opcional de mensajes de voz mediante Groq, Telegram Premium, endpoints compatibles con OpenAI o un modelo local de faster-whisper. Las sesiones se pueden almacenar como cadenas o en archivos SQLite persistentes, y admite proxies SOCKS, HTTP y MTProxy.
Enviar y modificar mensajes mediante un agente de IA conlleva riesgos reales, por lo que el proyecto ofrece controles como el modo de solo lectura, listas de extensiones de archivo permitidas y directorios raíz autorizados para acceder a archivos.
Funciones clave
- 01Ofrece más de 80 herramientas MCP para chats, grupos, mensajes, contactos, archivos multimedia y carpetas.
- 02Admite varias cuentas de Telegram, a las que se dirige mediante etiquetas.
- 03Ofrece un modo de solo lectura y listas de herramientas permitidas para limitar las operaciones de escritura.
- 04Transcribe mensajes de voz mediante Groq, Telegram Premium, APIs compatibles con OpenAI o Whisper local.
- 05Funciona mediante transportes stdio, HTTP transmisible o SSE.
- 06Admite proxies SOCKS, HTTP y MTProxy.
Casos de uso
- Permitir que Claude o Cursor resuman mensajes de Telegram sin leer y redacten respuestas.
- Buscar en el historial de chats y obtener contexto para un asistente de IA.
- Automatizar tareas de administración de grupos, como invitaciones, permisos y bloqueos.
- Compartir un servidor de Telegram entre varias sesiones de agentes de programación mediante HTTP.
Inicio rápido
- 1
Clona el repositorio
- 2
Instala las dependencias con uv
uv sync - 3
Ejecuta el servidor
Antes de usarlo
- Se necesita un ID y un hash de la API de Telegram; algunas funciones también requieren Telegram Premium.
- Varios motores de transcripción y el formato avanzado dependen de servicios de pago o que requieren una clave de API.
Temas
Preguntas frecuentes
- ¿Qué es telegram-mcp?
- Servidor MCP basado en Telethon que permite a clientes de IA como Claude y Cursor leer chats de Telegram y gestionar grupos, mensajes, archivos multimedia y contactos. Telegram MCP Server es una integración que ofrece operaciones de cuentas de Telegram, chats, mensajes, contactos, archivos multimedia, carpetas y administración a clientes compatibles con MCP, como Claude Desktop y Cursor. Está basado en Telethon y ofrece más de 80 herramientas para gestionar chats y grupos, mensajes (enviar, editar, reenviar, buscar, encuestas y reacciones), contactos, archivos multimedia, ajustes del perfil y de privacidad, y carpetas de Telegram.
- ¿telegram-mcp es gratuito? ¿Qué licencia tiene?
- telegram-mcp es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿telegram-mcp sigue mantenido?
- Mantenimiento activo. El último commit de telegram-mcp fue el 19 oct 2026.
- ¿Para qué puedo usar telegram-mcp?
- Permitir que Claude o Cursor resuman mensajes de Telegram sin leer y redacten respuestas. Buscar en el historial de chats y obtener contexto para un asistente de IA. Automatizar tareas de administración de grupos, como invitaciones, permisos y bloqueos. Compartir un servidor de Telegram entre varias sesiones de agentes de programación mediante HTTP.
- ¿Cómo se instala telegram-mcp?
- Clona el repositorio Instala las dependencias con uv: uv sync Ejecuta el servidor
- ¿Dónde consigo telegram-mcp?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/chigwell/telegram-mcp
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Agente de programación para terminal con LSP, depurador, navegador y herramientas para subagentes integrados, compatible con más de 60 proveedores de modelos.
Complemento de Blender y servidor MCP que permiten a asistentes de IA como Claude crear, modificar e inspeccionar escenas 3D en Blender mediante prompts.
Servidor MCP para agentes de programación con IA que mantiene los resultados sin procesar de las herramientas fuera de la ventana de contexto y conserva el estado de la sesión tras la compactación.
Un servidor MCP con un plugin nativo en C++ para Unreal Editor que permite a los asistentes de IA crear niveles, Blueprints, materiales y más en un editor en ejecución.
Conjunto de 23 plugins personalizados para hermes-agent que abarcan autonomía, enrutamiento de modelos, telemetría, control de costos, memoria y mensajería entre agentes.