telegram-mcp-readonly
Telegram MCP Readonly: servidor MCP de lectura exclusiva para Telegram. Busca chats, lee mensajes y descarga adjuntos sin enviar mensajes ni cambiar chats.
Ficha actualizada 23 sept 2026, 4:00 · upstream 23 sept 2026, 3:31 · release sin release detectada
Qué es telegram-mcp-readonly
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este proyecto proporciona una interfaz de contexto de modelo (MCP) para interactuar con cuentas de Telegram en modo read-only. Permite a los clientes conectarse a un servidor local que accede a la información pública disponible: historial de conversaciones, temas, mensajes ricos y metadatos personalizados como emojis. Los adjuntos se descargan confinalmente dentro de una carpeta configurada por el usuario. El diseño prioriza la privacidad mediante un allowlist explícito de permisos de lectura y la creación de sesiones privadas.
- Consultar historial de conversaciones de Telegram sin enviar mensajes ni cambiar chats
- Leer temas, respuestas y metadatos personalizados (emojis) de conversaciones públicas
- Descargar adjuntos de mensajes desde Telegram en modo read-only
- Conectar múltiples clientes a un mismo servidor local mediante un servicio compartido
- Proteger la privacidad al limitar el acceso a datos específicos de una cuenta
- Soporta múltiples clientes conectándose a través de un servicio HTTP local compartido
- Permite búsquedas globales y filtrado por carpetas dentro de chats
- Descarga confinalmente los adjuntos en una carpeta configurada por el usuario
- Protección explícita mediante allowlist de permisos de lectura
- Soporta metadatos personalizados como emojis en mensajes
- No puede acceder a datos privados (chats no públicos, chats con permisos restringidos)
- La descarga de adjuntos está limitada a una carpeta configurada por el usuario
- El servidor local consume recursos del sistema operativo en tiempo real
- No se pueden enviar mensajes ni cambiar chats desde la interfaz
- Depende de que Telegram permita acceso público a los datos necesarios
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instala con Python 3.10+ y uv: `uv sync --frozen` y `uv run python setup_readonly.py`. Configura un cliente MCP local mediante el archivo `.env.example`, asegurando que la carpeta de descarga adjuntos esté en una ruta segura. Para múltiples clientes, usa el servicio compartido HTTP descrito en docs/runbooks/operate-shared-readonly-service.md.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.