Telegram MCP сервер

Комплексная интеграция с Telegram для MCP-совместимых клиентов, которая предоставляет полный доступ к функциональности Telegram, включая обмен сообщениями, управление чатами, управление контактами и администрирование групп через Telethon.

Установка

Из исходного кода

git clone https://github.com/chigwell/telegram-mcp.git
cd telegram-mcp
uv sync

Сборка Docker

docker build -t telegram-mcp:latest .

Docker Compose

docker compose up --build

Запуск Docker

docker run -it --rm \
  -e TELEGRAM_API_ID="YOUR_API_ID" \
  -e TELEGRAM_API_HASH="YOUR_API_HASH" \
  -e TELEGRAM_SESSION_STRING="YOUR_SESSION_STRING" \
  telegram-mcp:latest

Конфигурация

Claude Desktop / Cursor

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/full/path/to/telegram-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

Доступные инструменты

Возможности

• Полные возможности управления чатами и группами
• Комплексные инструменты для сообщений, включая редактирование, пересылку и ответы
• Управление контактами и блокировка/разблокировка пользователей
• Функции администратора, такие как повышение/понижение пользователей и управление блокировками
• Создание и управление каналами и супергруппами
• Взаимодействие с inline-клавиатурой и нажатие кнопок
• Создание опросов и закрепление сообщений
• Функциональность поиска публичных чатов и сообщений
• Управление настройками приватности
• Получение информации о медиафайлах

Переменные окружения

Обязательные

• TELEGRAM_API_ID - Ваш Telegram API ID с my.telegram.org/apps
• TELEGRAM_API_HASH - Ваш Telegram API Hash с my.telegram.org/apps
• TELEGRAM_SESSION_STRING - Строка сессии, сгенерированная session_string_generator.py

Опциональные

• TELEGRAM_SESSION_NAME - Альтернатива строке сессии для файловых сессий

Примеры использования

Analyze my chat history and send a response to the group

Get my recent messages from a specific chat

Send a message to my project group

Create a new group with specific users

List all my contacts and find someone

Ресурсы

• GitHub Repository

Примечания

Требует Python 3.10+. Вам необходимо сгенерировать учетные данные API на my.telegram.org/apps и создать строку сессии, используя прилагаемый скрипт-генератор. Файловые операции (отправка файлов, загрузка медиа) были удалены из-за ограничений среды MCP. Сервер предоставляет валидацию входных данных, принимая целочисленные ID, строковые ID или имена пользователей для параметров чата/пользователя.