mcp-telegram (dryeab)
MCP Telegram с записью: агент отправляет, правит и удаляет сообщения, ищет чаты, ведет черновики и скачивает медиа в вашем аккаунте через MTProto
- 254 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Сервер пишет и удаляет сообщения от вашего имени в личных чатах, группах и каналах
- Сессия и API hash дают доступ ко всей переписке аккаунта, а скачанные медиа попадают на диск
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-telegram-dryeabОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Сервер пишет и удаляет сообщения от вашего имени в личных чатах, группах и каналах
- Сессия и API hash дают доступ ко всей переписке аккаунта, а скачанные медиа попадают на диск
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MCP Telegram от `dryeab` управляет вашим аккаунтом Telegram через MTProto. Сервер построен на Telethon и дает ассистенту девять инструментов в четырех группах. Сообщения: send_message отправляет текст или файл в личный чат, группу или канал, edit_message правит отправленное, delete_message удаляет одно или несколько сообщений, get_messages выдает историю с фильтрами. Поиск и навигация: search_dialogs находит людей, группы и каналы по имени или `username`, message_from_link открывает сообщение по ссылке Telegram. Еще два инструмента работают с черновиками: get_draft показывает текущий черновик чата, set_draft создает или очищает его. Для файлов есть media_download, он скачивает фото, видео и документы из сообщений. Подробные параметры выводит команда mcp-telegram `tools`.
Для кого. Для тех, кто в Claude Desktop или Cursor хочет поручить ассистенту полноценную работу с Telegram: писать, искать, править и скачивать вложения.
Подходит, если
- Нужно, чтобы ассистент подготовил ответ и сохранил его черновиком, а отправляли вы сами
- Требуется найти чат или канал по названию и вытащить историю с фильтрами
- Есть ссылка на сообщение Telegram, и нужно прочитать его содержимое и контекст
- Надо скачать вложения из сообщений: фото, видео, документы
- Хотите разослать рабочее объявление в группу или канал, где вы автор
Не подходит, если
- Нужен только обзор переписки без права писать: у `sparfenyuk` есть сервер, где отправки нет совсем
- Аккаунт рабочий, и случайное удаление сообщения недопустимо: delete_message есть среди инструментов
- Нужна работа через Bot API от имени бота: сервер входит под личным аккаунтом
- Один сеанс используют несколько копий сервера: общий файл сессии дает ошибку database is locked
Пример запроса к агенту
Найди в Telegram чат «Команда» и подготовь черновик ответа на последний вопрос про сроки, отправлять его не нужно.MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
API_IDобязательная- API ID приложения с my.telegram.org
API_HASHобязательная, секрет- API hash приложения с my.telegram.org
Ограничения
Нужны Python 3.10 или новее, инструмент uv, API ID и API hash с my.telegram.org, номер телефона в международном формате, код из Telegram и пароль двухфакторной защиты, если она включена. Данные входа сохраняются в файле сессии.
На один файл сессии допускается один запущенный экземпляр сервера, иначе Telethon выдает ошибку database is locked. Автор предупреждает, что нарушение правил Telegram может привести к ограничениям аккаунта. Последнее обновление репозитория датировано июнем 2025 года.
Доступность Telegram из России зависит от оператора и при подготовке карточки не проверялась.
Как отключить. Уберите блок mcp-telegram из конфигурации клиента. Команда mcp-telegram `logout` завершает текущую сессию, а mcp-telegram `clear-session` удаляет все сохраненные данные сессии. Пакет снимается командой uv tool `uninstall` mcp-telegram.
Частые вопросы
Как поставить MCP Telegram в Cursor или Claude Desktop?
Выполните uv tool install mcp-telegram, затем mcp-telegram login и введите API ID, API hash, телефон и код. В конфигурацию клиента добавьте блок с командой mcp-telegram, аргументом start и переменными API_ID и API_HASH, потом перезапустите приложение.
Какие инструменты есть в dryeab/mcp-telegram?
Девять: send_message, edit_message, delete_message, get_messages, search_dialogs, message_from_link, get_draft, set_draft и media_download. Параметры каждого выводит команда mcp-telegram `tools`.
Чем mcp-telegram от `dryeab` отличается от sparfenyuk/mcp-telegram?
У `dryeab` есть запись и поиск: отправка, правка, удаление, черновики, скачивание медиа. Сервер `sparfenyuk` умеет только читать диалоги и сообщения. Выбор зависит от того, готовы ли вы дать ассистенту право писать от вашего имени.
Что делать с ошибкой database is locked?
Ошибка возникает, когда несколько копий mcp-telegram используют один файл сессии. Оставьте один запущенный экземпляр. Если процесс завис, автор приводит в разделе Troubleshooting способ принудительно остановить старые процессы.
Как сбросить вход в mcp-telegram и удалить сохраненные данные?
Команда mcp-telegram `logout` выходит из текущей сессии, команда mcp-telegram `clear-session` стирает все сохраненные данные сессии. Для нового входа снова выполните mcp-telegram login.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Telegram — все инструментыMCP Telegram для чтения: агент получает список диалогов и непрочитанные сообщения вашего аккаунта через MTProto, писать от вашего имени он не умеет
Telegram MCP от chaindead
Telegram MCP
MCP-сервер на Go для вашего Telegram: агент читает диалоги и непрочитанное, отмечает прочитанным, ответы кладет в черновики
MCP-сервер на Telethon: агент читает и отправляет сообщения, управляет чатами, контактами и папками вашего аккаунта Telegram
Telegram API MCP
telegram-api-mcp
MCP-сервер для Telegram Bot API: сообщения, каналы, форумы, платежи и длинные посты от имени бота с учетом лимитов Telegram
MCP-сервер для почты Mail.ru в Claude.ai и отдельный Telegram-бот, который каждые 15 минут проверяет ящик и присылает уведомления о важных письмах
MCP доставки отчетов Трекера в Telegram
Telegram Delivery MCP
Вспомогательный MCP-сервер, который берет готовый отчет по задачам Яндекс Трекера и отправляет его в Telegram через существующий бот-сервис
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| mcp-telegram (dryeab) (эта запись) | нет | API-ключ | 254 | |
| mcp-telegram (sparfenyuk) | нет | API-ключ | 190 | MCP Telegram только для чтения диалогов и сообщений |
| Telegram MCP Server | нет | API-ключ | 1 920 | другой MCP-сервер на Telethon с управлением чатами, контактами и папками |
| Telegram API MCP | нет | API-ключ | 33 | Bot API от имени бота вместо личного аккаунта |
Коротко о README
В документации описаны установка одной командой, интерактивный вход через mcp-telegram login, пример конфигурации для Claude Desktop и Cursor с указанием, как найти полный путь к команде, и таблицы инструментов по группам. Отдельный раздел советует не запускать несколько копий на одной сессии и предупреждает о правилах Telegram.