v3.2.46patch
Исправлена ошибка BotMethodInvalidError при аутентификации клиента как бота.
- Fixed: Исправлена обработка исключения BotMethodInvalidError при работе клиента в режиме бота.
chigwell/telegram-mcp
Сервер Telegram MCP на базе Telethon для чтения чатов, управления группами и отправки/изменения сообщений, медиа, контактов и настроек.
MCP⭐ 1 635Pythonпоследний релиз: v3.2.46
Что это за инструмент
Telegram MCP Server — это серверная надстройка на базе Telethon, которая позволяет MCP-совместимым клиентам (например, Claude или Cursor) управлять аккаунтом Telegram, читать чаты и отправлять сообщения.
Зачем нужен
Инструмент решает задачу интеграции возможностей Telegram с AI-агентами через стандарт Model Context Protocol. Он полезен для автоматизации рутинных операций в мессенджере, таких как анализ истории переписки, модерация групп и массовая рассылка, непосредственно из интерфейса AI-ассистента.
Что можно реализовать
- Анализ истории чатов и отправка ответов от имени пользователя через Claude Desktop
- Автоматическая модерация групп: управление администраторами, баны, настройки slow mode
- Мониторинг и обработка входящих сообщений с возможностью ответа и пересылки
- Управление контактами: поиск, добавление, блокировка и экспорт/импорт списков
- Работа с медиа: отправка файлов, голосовых сообщений, стикеров и GIF-анимации
Ключевые возможности
- Более 80 инструментов MCP, охватывающих аккаунты, чаты, сообщения, контакты, медиа и профили
- Поддержка мультиаккаунтной работы с маршрутизацией запросов по меткам
- Возможность запуска в режиме «только чтение» (read-only) для ограничения прав на запись
- Готовая поддержка Docker и валидации конфигурации через CI/CD
- Санитизация пользовательского контента и возврат результатов в структурированном JSON
👤 Кому подойдёт: разработчики, использующие MCP-клиенты (Claude, Cursor), и технические специалисты, занимающиеся автоматизацией процессов в Telegram
Релизы
v3.2.44patch
Исправлена нормализация расширения .oga в .ogg для загрузки аудио в Groq.
- Fixed: Исправлена нормализация расширения .oga в .ogg для загрузки аудио в Groq.
v3.2.43patch
Исправлена ошибка, из-за которой на Windows блокировалась установка пакета в режиме редактирования.
- Fixed: Устранена ошибка, при которой защита установки отклоняла редактируемые сборки на Windows.
v3.2.42minor
Пользователи могут настраивать разрешенные расширения файлов для каждого инструмента через переменную TELEGRAM_FILE_EXTENSIONS.
- Added: Добавлена возможность конфигурации разрешенных расширений файлов для каждого инструмента через переменную TELEGRAM_FILE_EXTENSIONS.
v3.2.41patch
Исправлена ошибка, связанная с отображением ссылок в контексте сообщений.
- Fixed: Исправлена проблема с доступом к ссылкам в контексте сообщений.
v3.2.40patch
Исправлена привязка вызовов инструментов MCP в релизе v3.2.40.
- Fixed: Исправлена ошибка, связанная с привязкой вызовов инструментов MCP.
v3.2.39patch
Обновлена зависимость Telethon до версии 1.45.0 с поддержкой MTProto layer 229.
- Added: Требование к библиотеке Telethon повышено до версии 1.45.0 и выше.
- Added: Добавлена поддержка MTProto layer 229.
v3.2.38patch
Исправлено зависание инструментов работы с файлами из-за таймаута запросов к корням/спискам.
- Fixed: Запросы к корням и спискам теперь завершаются с таймаутом, предотвращая зависание инструментов работы с файлами.
- Added: Первый вклад в проект внес новый контрибьютор @thunderom.
v3.2.36patch
В версии v3.2.36 добавлена возможность нажатия на чипы с датами в сообщениях благодаря функции format_date.
- Added: Добавлена поддержка кликабельных чипов с датами в сообщениях через функцию format_date.
v3.2.35patch
Исправлена передача ID чата в запросах на редактирование сообщений и добавлена поддержка метаданных пользовательских эмодзи.
- Fixed: Исправлена передача разрешённого Chat.id в запросах на редактирование сообщений в группах.
- Added: Добавлена возможность получения метаданных пользовательских эмодзи.
v3.2.34minor
В Telegram MCP v3.2.34 добавлен инструмент remove_user для удаления участников без блокировки.
- Added: Добавлен инструмент remove_user для удаления пользователей из групп без применения бана.
v3.2.33minor
Добавлен режим блокировки сессий (singleton lock) для обеспечения совместного доступа.
- Added: Реализован режим блокировки сессий (shared session lock mode) для работы в режиме синглтона.
v3.2.32minor
Добавлена опциональная маршрутизация пересылаемых сообщений по отправителю и теме форума.
- Added: Добавлена опциональная маршрутизация пересылаемых сообщений по отправителю и теме форума.
v3.2.31patch
Исправлено чтение форматированных сообщений в Telegram, которые ранее возвращались пустыми.
- Fixed: Исправлено чтение сообщений с блочным форматированием, которые ранее отображались как пустые.
- Added: Первый вклад в проект внес участник @Rangezi.
v3.2.30patch
Исправлена загрузка медиафайлов с привязкой к лимитам и этапам обработки.
- Fixed: Исправлена ошибка при скачивании медиа, связанная с контролем лимитов и этапов.
v3.2.28patch
Исправлено автоматическое создание разрешённых корневых директорий и добавлена фильтрация по topic_id в get_history.
- Fixed: Исправлена ошибка автоматического создания разрешённых корневых директорий.
- Added: В метод get_history добавлена фильтрация по идентификатору темы (topic_id).
v3.2.27minor
В Telegram MCP добавлена возможность планирования отправки файлов и альбомов с указанием даты.
- Added: Функции send_file и send_album теперь поддерживают параметр schedule_date для отправки сообщений по расписанию.
v3.2.26patch
Исправлена сломанная диаграмма истории звёзд в README и добавлена обработка лимитов FloodWait с рекомендациями по ожиданию.
- Fixed: Восстановлена неработающая диаграмма истории звёзд в файле README.
- Added: В рантайме теперь отображаются лимиты FloodWait с инструкциями по времени ожидания.
- Новые участники: @Dessalines39394 и @TheMRVX сделали свои первые вклады в проект.
v3.2.25minor
Добавлена функция транскрипции голосовых сообщений и видео-заметок в Telegram.
- Added: Реализована транскрипция голосовых сообщений и видео-заметок.
v3.2.24patch
Вышла версия v3.2.24.
v3.2.23patch
Исправлено отсутствие вызова get_media_label в list_messages и проблема с захватом слотов сессий на Windows.
- Fixed: Исправлено: функция list_messages больше не пропускает вызов get_media_label.
- Fixed: Решена проблема с захватом уникальных слотов сессий в среде Windows.
- Added: Первый вклад в проект внес участник @PathKnower.
v3.2.22patch
Исправлена ошибка AuthKeyDuplicatedError при запуске нескольких экземпляров сервера.
- Fixed: Устранена ошибка AuthKeyDuplicatedError, возникавшая при одновременной работе нескольких экземпляров сервера.
v3.2.21patch
Обновление зависимостей, добавление проверки аватаров в чатах и исправление приглашения пользователей в базовые группы.
- Added: В методе get_chat теперь доступна информация о наличии фото профиля (has_photo).
- Fixed: Исправлено приглашение пользователей в базовые группы через messages.AddChatUser.
- Обновлены заблокированные зависимости проекта.
v3.2.20patch
Исправлена ошибка, теперь при сдвиге схемы MTProto сообщается конкретная причина, а не общий код ошибки.
- Fixed: Теперь при обнаружении сдвига схемы MTProto выводится понятное сообщение об ошибке вместо общего кода.
v3.2.19minor
В релизе v3.2.19 добавлена поддержка параметра topic_id в инструментах отправки медиа.
- Added: Добавлена поддержка topic_id в инструментах отправки медиа.
v3.2.17patch
Исправлена зависимость MCP, зафиксирована версия ниже 2 для стабильности установки через Docker и pip.
- Fixed: Зафиксирована версия библиотеки MCP строго ниже 2, чтобы обеспечить корректную работу установок через Docker и pip.
- Added: Первый вклад в проект внес новый участник @bobmoroshev.
v3.2.15patch
Исправлено сохранение атрибуции каналов при пересылке сообщений.
- Fixed: Сохраняется информация об авторстве канала в пересылаемых сообщениях.
v3.2.14patch
Исправлена работа псевдонимов для не-ASCII имён в контактах и улучшено запоминание контактов по используемым именам.
- Fixed: Исправлена ошибка, из-за которой псевдонимы становились непригодными для имён, содержащих символы не из ASCII.
- Added: Улучшено запоминание контактов: теперь система запоминает их по тем именам, которые вы используете.
v3.2.0minor
Добавлена поддержка streamable HTTP и обновлена библиотека telethon для исправления ошибок.
- Added: Добавлен транспорт streamable HTTP и документация по настройке общего контейнера.
- Fixed: Обновлена зависимость telethon до версии 1.44.0, исправлена ошибка TypeNotFoundError при разрешении числовых ID пользователей.
v3.1.22minor
Добавлена опциональная поддержка транспорта SSE и передача @username/ID в списках.
- Added: Появилась опциональная поддержка транспорта SSE.
- Added: В списки добавлена передача @username или ID.