Repolode
Предложить
chigwell

chigwell/telegram-mcp

MCP-сервер на базе Telethon, который позволяет AI-клиентам вроде Claude и Cursor читать чаты Telegram и управлять группами, сообщениями, медиа и контактами.

Открыть на GitHub
Звёзды
1,850
Форки
470
Открытые issues
31
Последний коммит
24 часа назад

Что это?

Telegram MCP Server — интеграция, которая предоставляет MCP-совместимым клиентам, например Claude Desktop и Cursor, доступ к операциям с аккаунтом Telegram, чатами, сообщениями, контактами, медиа, папками и администрированием. Сервер построен на Telethon и предлагает более 80 инструментов для работы с чатами и группами, сообщениями (отправка, редактирование, пересылка, поиск, опросы, реакции), контактами, медиа, настройками профиля и конфиденциальности, а также папками Telegram.

Сервер поддерживает несколько аккаунтов с маршрутизацией по меткам. Доступ можно ограничить только чтением или разрешённым списком чатов. Сервер может работать через stdio, streamable HTTP или SSE и поддерживает опциональную транскрибацию голосовых сообщений через Groq, Telegram Premium, совместимые с OpenAI эндпоинты или локальную модель faster-whisper. Сессии можно хранить в виде строк или в постоянных файлах SQLite; также поддерживаются прокси SOCKS, HTTP и MTProxy.

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

Ключевые возможности

  • 01Предоставляет более 80 инструментов MCP для работы с чатами, группами, сообщениями, контактами, медиа и папками.
  • 02Поддерживает несколько аккаунтов Telegram с маршрутизацией по меткам.
  • 03Предлагает режим только для чтения и списки разрешённых инструментов, чтобы ограничить операции записи.
  • 04Транскрибирует голосовые сообщения через Groq, Telegram Premium, совместимые с OpenAI API или локальный Whisper.
  • 05Работает через транспорт stdio, streamable HTTP или SSE.
  • 06Поддерживает прокси SOCKS, HTTP и MTProxy.

Сценарии использования

  • Позволяет Claude или Cursor кратко пересказывать непрочитанные сообщения Telegram и составлять ответы.
  • Помогает искать сообщения в истории чатов и собирать контекст для AI-ассистента.
  • Автоматизирует администрирование групп, например приглашения, настройку разрешений и блокировки.
  • Позволяет использовать один сервер Telegram в нескольких сессиях coding-агентов через HTTP.

Быстрый старт

  1. 1

    Клонируйте репозиторий

  2. 2

    Установите зависимости с помощью uv

    uv sync
  3. 3

    Запустите сервер

Что важно знать

  • Требуются ID и хеш Telegram API, а для некоторых функций нужен Telegram Premium.
  • Некоторые движки транскрибации и расширенное форматирование зависят от платных сервисов или сервисов, для которых нужен API-ключ.

Темы

#mcp#telegram#telethon#messaging#chat-management#ai-agent#voice-transcription#admin#api#contacts

Частые вопросы

Что такое telegram-mcp?
MCP-сервер на базе Telethon, который позволяет AI-клиентам вроде Claude и Cursor читать чаты Telegram и управлять группами, сообщениями, медиа и контактами. Telegram MCP Server — интеграция, которая предоставляет MCP-совместимым клиентам, например Claude Desktop и Cursor, доступ к операциям с аккаунтом Telegram, чатами, сообщениями, контактами, медиа, папками и администрированием. Сервер построен на Telethon и предлагает более 80 инструментов для работы с чатами и группами, сообщениями (отправка, редактирование, пересылка, поиск, опросы, реакции), контактами, медиа, настройками профиля и конфиденциальности, а также папками Telegram.
telegram-mcp можно использовать бесплатно? Какая у него лицензия?
telegram-mcp распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
telegram-mcp всё ещё поддерживается?
Активно поддерживается. Последний коммит в telegram-mcp — 19 окт. 2026 г..
Для чего можно использовать telegram-mcp?
Позволяет Claude или Cursor кратко пересказывать непрочитанные сообщения Telegram и составлять ответы. Помогает искать сообщения в истории чатов и собирать контекст для AI-ассистента. Автоматизирует администрирование групп, например приглашения, настройку разрешений и блокировки. Позволяет использовать один сервер Telegram в нескольких сессиях coding-агентов через HTTP.
Как установить telegram-mcp?
Клонируйте репозиторий Установите зависимости с помощью uv: uv sync Запустите сервер
Где скачать telegram-mcp?
Исходный код и инструкции по установке — на GitHub: https://github.com/chigwell/telegram-mcp

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты