Что такое Telegram MCP и зачем это нужно
Разработчик chigwell представил сервер Telegram MCP — интеграцию, использующую библиотеку Telethon для экспорта функционала Telegram через Model Context Protocol. Теперь AI-агенты, такие как Claude или Cursor, могут не просто генерировать текст, а напрямую взаимодействовать с мессенджером: читать историю, управлять группами, отправлять медиа и даже администрировать каналы. Это закрывает критический пробел в автономности AI-ассистентов, позволяя им действовать в реальной коммуникации, а не только в рамках IDE или браузера.
80+ инструментов для полного контроля
Репозиторий предлагает более 80 инструментов, разделенных на ключевые категории. Особое внимание уделено гибкости форматирования и работе с контактами. Сервер поддерживает как классический Markdown/HTML, так и rich-форматирование (таблицы, формулы, сворачиваемые секции), которое требует подписки Telegram Premium. Если у аккаунта нет Premium, AI автоматически вернет ошибку telegram_premium_required и предложит переформатировать сообщение, чтобы избежать сбоев.
Ключевая фишка — система «запоминаемых контактов» (aliases). Инструмент set_contact_alias позволяет AI запомнить, как вы называете человека (например, «андрей бекендер»). В дальнейшем запросы send_message("андрей бекендер", ...) будут работать корректно. Система использует fuzzy-матчинг для предложений, но для отправки требует подтверждения, чтобы избежать ошибок в склонениях (разница между «Лена» и «Леня» может привести к отправке не тому человеку).
Транскрипция голосовых: Groq vs Telegram
Проект реализует две стратегии обработки голосовых сообщений, каждая со своими компромиссами:
| Параметр | Engine: Groq (по умолчанию) | Engine: Telegram |
|---|---|---|
| Модель | whisper-large-v3-turbo | Native Telegram Premium |
| Стоимость | Платно (API ключ Groq) | Бесплатно (требует Premium) |
| Качество | Высокое, не обрезает конец | Часто обрезает последние слова (2/3 случаев) |
| Лимиты | До 25 МБ (зависит от тарифа) | Нет жестких лимитов на размер файла |
| Кэширование | SQLite, защита от дублирования запросов | SQLite, защита от дублирования запросов |
Результаты транскрипции кэшируются локально. Если несколько агентов запросят один и тот же голосовой файл одновременно, сервер выполнит запрос один раз и вернет результат всем, экономя средства и время.
Безопасность и приватность
Разработчик уделил внимание безопасности: все результаты, содержащие пользовательские данные, санитизируются. Контакты хранятся в файле aliases.json с правами доступа 600 (только владелец). Поддерживается настройка Allowlist для ограничения доступа к чатам, а также прокси-поддержка и изоляция данных в Docker-контейнерах. Транскрипты хранятся в папке data/transcripts с правами 700/600, так как содержат текст личных переписок.
Как запустить
Для использования требуется Python-окружение и API-ключи (для Groq). Проект поддерживает мультиаккаунтную настройку, где вызовы инструментов маршрутизируются по меткам аккаунтов. Документация на GitHub содержит примеры конфигурации для Claude и Cursor, а также инструкции по развертыванию через Docker.
Источник: Github ↗