MCP-сервер для Telegram на Rust
MCP расшифровывается как Model Context Protocol: через него ИИ‑агент работает с инструментами. Этот сервер на Rust даёт агенту точный контекст Telegram и управляемые вложения без выгрузки аккаунта. В моей схеме агент готовит ответ, а уходит он только после моего подтверждения. Режим согласования включается настройкой: без него сервер отправляет напрямую и даёт меньше гарантий. Результат сохраняется после перезапуска.
- Что получает агент
- ИИ выбирает один диалог и сообщение, затем читает ограниченный фрагмент вокруг него и не выгружает весь аккаунт.
- Что остаётся в рабочей папке
- Исходный файл скачивается в папку, где имя файла и есть его SHA-256. Изменённая версия создаётся рядом и не перезаписывает оригинал.
- Что нужно для ответа
- В моей схеме перед отправкой сервер связывает аккаунт, адресата, ответ на сообщение, текст, хеш материала и срок действия с одной личной карточкой согласования. Отправка ждёт моего подтверждения, а результат сохраняется.
Публичное демо и исходный код
Текущая предварительная публичная версия: v0.2.0. Демо запускает собранный MCP-сервер по stdio без Telegram-аккаунта, сети и реальной доставки.
- 14 инструментовУ каждого инструмента есть схемы входа и выхода, MCP-аннотации и единый структурированный результат после разбора аргументов.
- Собранный сервер по stdioИнтеграционный тест запускает собранный сервер и подключает rmcp-клиент через системные потоки ввода-вывода.
- Идентичность файлаДемо находит сообщение с договором, скачивает PDF, создаёт изменённую копию, отвечает файлом с привязанным SHA-256 и перечитывает результат.
- Состояние после рестартаПодготовленный текст, согласование, Telegram random_id и результат отправки остаются доступны после перезапуска.
Задача целиком
ИИ‑агент через MCP может найти переписку, восстановить точный контекст сообщения, перенести вложение в контролируемую локальную папку и подготовить ответ без выгрузки всего аккаунта.
Сам сервер не содержит ИИ‑агента. Рассуждение и изменение файлов происходят в хосте; сервер на Rust отвечает за точный аккаунт, чат и сообщение, границы чтения, состояние согласования и результат отправки.
Что действительно запускает публичное демо
ИИ-ХОСТ
найти сообщение | прочитать контекст
↓
TELEGRAM MCP (Rust через stdio)
скачать неизменяемый PDF | вернуть путь + SHA-256
↓
УПРАВЛЯЕМАЯ ПАПКА
хост создаёт изменённую копию
↓
ПОДГОТОВЛЕННЫЙ ОТВЕТ
точный адресат | ID сообщения | хеш материала
↓
ОТПРАВКА + РЕЗУЛЬТАТ
сохранённое состояние | ID сообщения в TelegramЧто доступно через сервер
- MCP-инструменты
- 14 типизированных операций
- Сообщения
- ограниченный поиск и контекст
- Вложения
- неизменяемые оригиналы + SHA-256
- Согласование текста
- личная кнопка в Telegram
- Восстановление отправки
- сохраняемый журнал SQLite
- Протокол
- стабильный MCP 2025-11-25
Почему согласование переживает перезапуск
- Проблема
- Процесс может остановиться после того, как Telegram принял сообщение, но до записи результата. Скопированная или устаревшая кнопка не должна становиться новым разрешением на отправку.
- Решение
- Сохраняются подготовленный материал, стабильный Telegram random_id, точная карточка согласования, ID нажавшего пользователя, срок действия и результат Telegram с ID отправленного сообщения. После сбоя продолжается та же операция, и новая не создаётся.
- Почему не этот вариант
- После сетевого сбоя прямая отправка не различает два случая: сообщение не ушло или ушло, но ответ потерялся. Повтор может создать дубль.
Почему чат и файл задаются точно
- Повторно используемые ссылки на чаты: Возвращённый адрес можно снова передать серверу как username или канонический числовой ID; приватный диалог не угадывается по подписи интерфейса.
- Управляемые папки: Загружаемый файл должен находиться внутри папки выбранного аккаунта, поэтому произвольный путь на машине нельзя отправить через Telegram.
- Неизменяемые оригиналы: Имя скачанного файла и есть его SHA-256. Изменение создаёт соседний файл с новым хешем, и исходник остаётся нетронутым.
- Один владелец сессии: Telegram-сессией и обработчиком согласований одновременно владеет только один процесс.
Реализация
- Ядро
- Rust 2024, Tokio, clap
- MCP
- rmcp 1.7.0, stdio, serde, schemars
- Telegram
- ferogram, MTProto, согласование через Bot API
- Состояние
- журнал SQLite, кеш вложений с именем файла по SHA-256