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

MCP-сервер для Telegram с поддержкой двух режимов: Bot API (httpx) для быстрой интеграции ботов и MTProto (Telethon) для полноценного доступа к учетной записи пользователя.

CI codecov PyPI Docker License: MIT

Python Telegram MCP semantic-release Renovate

Возможности

  • Двойной режим -- Bot API (httpx) для ботов, MTProto (Telethon) для учетных записей пользователей

  • 6 инструментов с диспетчеризацией действий: message, chat, media, contact, config, help

  • Автоопределение режима -- Укажите токен бота для режима бота или учетные данные API для режима пользователя

  • Веб-аутентификация OTP -- Аутентификация через браузер с поддержкой удаленного реле для headless-сред

  • Аннотации инструментов -- Каждый инструмент объявляет readOnlyHint, destructiveHint, idempotentHint, openWorldHint

  • Ресурсы MCP -- Документация доступна в виде ресурсов telegram://docs/*

  • Повышенная безопасность -- Защита от SSRF, предотвращение обхода путей (path traversal), очистка ошибок

Related MCP server: Telegram MCP Server & Channel Monitor

Установка

С помощью AI-агента -- скопируйте и отправьте это своему AI-агенту:

Пожалуйста, настрой для меня better-telegram-mcp. Следуй этому руководству: https://raw.githubusercontent.com/n24q02m/better-telegram-mcp/main/docs/setup-with-agent.md

Ручная установка -- следуйте docs/setup-manual.md

Инструменты

Инструмент

Действия

Описание

message

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

Отправка, редактирование, удаление, пересылка сообщений. Закрепление, реакции, поиск, просмотр истории

chat

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

Список и управление чатами, группами, каналами. Участники, администрирование, темы форума

media

send_photo, send_file, send_voice, send_video, download

Отправка фото, файлов, голосовых заметок, видео. Загрузка медиа из сообщений

contact

list, search, add, block

Список, поиск, добавление контактов. Блокировка/разблокировка пользователей (только в режиме пользователя)

config

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

Статус сервера, настройки среды выполнения, кэш, настройка учетных данных (реле, статус, сброс, завершение)

help

--

Полная документация по любой теме

Ресурсы MCP

URI

Содержимое

telegram://docs/messages

Справочник по операциям с сообщениями

telegram://docs/chats

Справочник по управлению чатами

telegram://docs/media

Справочник по отправке/загрузке медиа

telegram://docs/contacts

Справочник по управлению контактами

telegram://stats

Вся документация целиком

Безопасность

  • Защита от SSRF -- Все URL проверяются на соответствие внутренним/частным диапазонам IP, блокировка DNS-ребиндинга

  • Предотвращение обхода путей -- Пути к файлам проверяются, доступ к чувствительным директориям заблокирован

  • Безопасность файлов сессий -- Права доступа 600, 2FA только через веб-интерфейс (никогда не хранятся в переменных окружения)

  • Очистка ошибок -- Учетные данные никогда не раскрываются в сообщениях об ошибках

Сборка из исходного кода

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

Лицензия

MIT -- См. 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