Skip to main content
Glama
deenesjakoruzh
n24q02m

Better Telegram MCP

by n24q02m
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

Better Telegram MCP

mcp-name: io.github.n24q02m/better-telegram-mcp

Servidor MCP para Telegram con soporte de modo dual: Bot API (httpx) para integraciones rápidas de bots y MTProto (Telethon) para acceso completo a cuentas de usuario.

CI codecov PyPI Docker License: MIT

Python Telegram MCP semantic-release Renovate

Características

  • Modo dual -- Bot API (httpx) para bots, MTProto (Telethon) para cuentas de usuario

  • 6 herramientas con despacho de acciones: message, chat, media, contact, config, help

  • Modo de detección automática -- Establezca el token del bot para el modo bot, o las credenciales de API para el modo usuario

  • Autenticación OTP basada en web -- Autenticación basada en navegador con soporte de retransmisión remota para entornos sin interfaz gráfica (headless)

  • Anotaciones de herramientas -- Cada herramienta declara readOnlyHint, destructiveHint, idempotentHint, openWorldHint

  • Recursos MCP -- Documentación disponible como recursos telegram://docs/*

  • Seguridad reforzada -- Protección contra SSRF, prevención de recorrido de rutas (path traversal), saneamiento de errores

Configuración

Con agente de IA -- copie y envíe esto a su agente de IA:

Por favor, configure better-telegram-mcp para mí. Siga esta guía: https://raw.githubusercontent.com/n24q02m/better-telegram-mcp/main/docs/setup-with-agent.md

Configuración manual -- siga docs/setup-manual.md

Herramientas

Herramienta

Acciones

Descripción

message

send, edit, delete, forward, pin, react, search, history

Enviar, editar, eliminar, reenviar mensajes. Fijar, reaccionar, buscar, navegar por el historial

chat

list, info, create, join, leave, members, admin, settings, topics

Listar y gestionar chats, grupos, canales. Miembros, administración, temas de foro

media

send_photo, send_file, send_voice, send_video, download

Enviar fotos, archivos, notas de voz, vídeos. Descargar medios de los mensajes

contact

list, search, add, block

Listar, buscar, añadir contactos. Bloquear/desbloquear usuarios (solo modo usuario)

config

status, set, cache_clear, setup_status, setup_start, setup_reset, setup_complete

Estado del servidor, ajustes de tiempo de ejecución, caché, configuración de credenciales (retransmisión, estado, reinicio, finalización)

help

--

Documentación completa para cualquier tema

Recursos MCP

URI

Contenido

telegram://docs/messages

Referencia de operaciones de mensajes

telegram://docs/chats

Referencia de gestión de chats

telegram://docs/media

Referencia de envío/descarga de medios

telegram://docs/contacts

Referencia de gestión de contactos

telegram://stats

Toda la documentación combinada

Seguridad

  • Protección contra SSRF -- Todas las URLs validadas contra rangos de IP internos/privados, bloqueo de rebinding de DNS

  • Prevención de recorrido de rutas -- Rutas de archivo validadas, directorios sensibles bloqueados

  • Seguridad de archivos de sesión -- Permisos 600, 2FA solo a través de interfaz web (nunca almacenado en variables de entorno)

  • Saneamiento de errores -- Las credenciales nunca se filtran en los mensajes de error

Construir desde el código fuente

git clone https://github.com/n24q02m/better-telegram-mcp.git
cd better-telegram-mcp
uv sync
uv run better-telegram-mcp

Licencia

MIT -- Ver LICENSE.

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/n24q02m/better-telegram-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server