DM

dryeab/mcp-telegram

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

254 stars 39 forks Качество 63 Тренд 18MIT

dryeab/mcp-telegram — это кандидат на MCP-сервер, импортированный из https://github.com/dryeab/mcp-telegram..

Обзор

dryeab/mcp-telegram — это кандидат на MCP-сервер, импортированный из https://github.com/dryeab/mcp-telegram..

Обзор (машинный перевод)

Включите LLM для управления вашим Telegram

Подключать большие языковые модели к Telegram через протокол Model Context Protocol (MCP).

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


Содержание  

  • 🚀 Начало работы
  • Предварительные требования
  • Установка
  • ⚙️ Использование
  • Вход
  • Подключение к серверу MCP
  • 🧰 Доступные инструменты
  • 📨 Инструменты обмена сообщениями
  • 🔍 Поиск и навигация
  • 📝 Управление драфтом
  • 📂 Обработка медиа
  • 🛠️ Устранение неисправностей
  • 🤝 Вклад
  • 📝 Лицензия

🚀 Начало

Требования

  • Python 3.10 или выше
  • uv Установка через официальный UV-гайд.

Установка

Установите инструмент CLI [[T1]:

⚙️ Использование

[! ВАЖНО] Пожалуйста, убедитесь, что вы прочитали и поняли условия использования Telegram перед использованием этого инструмента. Неправильное использование этого инструмента может привести к ограничениям аккаунта.

Инструмент командной строки mcp-telegram — это ваша точка входа.

Войти

Во-первых, выполните аутентификацию с помощью вашего аккаунта Telegram:

Эта интерактивная команда подскажет вам:

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Connect Large Language Models to Telegram via the Model Context Protocol (MCP).

Built with Telethon, this server allows AI agents to interact with Telegram, enabling features like sending/editing/deleting messages, searching chats, managing drafts, downloading media, and more using the MTProto.



🚀 Getting Started

Prerequisites

Installation

Install the mcp-telegram CLI tool:

uv tool install mcp-telegram

⚙️ Usage

[!IMPORTANT] Please ensure you have read and understood Telegram’s ToS before using this tool. Misuse of this tool may result in account restrictions.

The mcp-telegram command-line tool is your entry point.

mcp-telegram --help # See all commands

Login

First, authenticate with your Telegram account:

mcp-telegram login

This interactive command will prompt you for:

  • API ID & API Hash: Obtain these from my.telegram.org/apps.
  • Phone Number: Your Telegram-registered phone number (international format, e.g., +1234567890).
  • Verification Code: Sent to your Telegram account upon first login.
  • 2FA Password: If you have Two-Factor Authentication enabled.

Your credentials are securely stored in the session file for future use.

[!WARNING] Keep your API credentials private and never share them publicly

[!NOTE]

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

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

{ "mcpServers": { "mcp-telegram": { "command": "mcp-telegram" /* Use full path if client can't find the command (e.g. "/usr/local/bin/mcp-telegram"). See IMPORTANT section below for full path instructions. */, "args": ["start"], "env": { "API_ID": "<your_api_id>", "API_HASH": "<your_api_hash>" } } } }