Skip to main content
Glama
deenesjakoruzh
n24q02m

Better Telegram MCP

by n24q02m
OverviewSchemaSourceRelated ServersDiscussionsAdmin
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

Related MCP server: Telegram MCP Server & Channel Monitor

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 deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessResponsive

Resources

Related MCP Connectors

Related MCP Servers

  • telegram-bot-mcp

    FantomaSkaRus1
    A
    license
    B
    quality
    C
    maintenance
    Full-featured Telegram Bot API server for MCP (Model Context Protocol). 174 tools covering the entire Bot API — messages, chats, stickers, payments, forums, stories, and more.
    100
    31 npm
    7
    MIT

  • Telegram MCP Server & Channel

    ruchiayeon
    A
    license
    A
    quality
    D
    maintenance
    A comprehensive MCP server providing 35 tools for managing Telegram messages, media, and chat interactions via the Bot API. It also features a real-time monitoring system using the Telethon User API to log messages from specific channels.
    35
    Apache 2.0

  • tg-mcp-guarded

    matskevich
    A
    license
    Not graded
    quality
    C
    maintenance
    Dual-plane Telegram MCP server providing read-only analytics and guarded write actions with built-in rate limiting, anti-spam protection, and session management.
    9
    MIT