Иван Планкин

Все проекты

MCP-сервер для Telegram на Rust

MCP расшифровывается как Model Context Protocol: через него ИИ‑агент работает с инструментами. Этот сервер на Rust даёт агенту точный контекст Telegram и управляемые вложения без выгрузки аккаунта. В моей схеме агент готовит ответ, а уходит он только после моего подтверждения. Режим согласования включается настройкой: без него сервер отправляет напрямую и даёт меньше гарантий. Результат сохраняется после перезапуска.

Что получает агент
ИИ выбирает один диалог и сообщение, затем читает ограниченный фрагмент вокруг него и не выгружает весь аккаунт.
Что остаётся в рабочей папке
Исходный файл скачивается в папку, где имя файла и есть его SHA-256. Изменённая версия создаётся рядом и не перезаписывает оригинал.
Что нужно для ответа
В моей схеме перед отправкой сервер связывает аккаунт, адресата, ответ на сообщение, текст, хеш материала и срок действия с одной личной карточкой согласования. Отправка ждёт моего подтверждения, а результат сохраняется.

Публичное демо и исходный код

Текущая предварительная публичная версия: v0.2.0. Демо запускает собранный MCP-сервер по stdio без Telegram-аккаунта, сети и реальной доставки.

  1. 14 инструментовУ каждого инструмента есть схемы входа и выхода, MCP-аннотации и единый структурированный результат после разбора аргументов.
  2. Собранный сервер по stdioИнтеграционный тест запускает собранный сервер и подключает rmcp-клиент через системные потоки ввода-вывода.
  3. Идентичность файлаДемо находит сообщение с договором, скачивает PDF, создаёт изменённую копию, отвечает файлом с привязанным SHA-256 и перечитывает результат.
  4. Состояние после рестартаПодготовленный текст, согласование, 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