
dryeab/mcp-telegram
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
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
- Python 3.10 or higher
uvInstall via the official uv guide.
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]
Установка
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>"
}
}
}
}