Better Telegram MCP

Name: Better Telegram MCP
Author: n24q02m

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

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

Возможности

Двойной режим -- 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), очистка ошибок

Установка

С помощью 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.

Better Telegram MCP

Better Telegram MCP

Возможности

Установка

Инструменты

Ресурсы MCP

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

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

Лицензия

Resources

Latest Blog Posts

MCP directory API