KornArs/mcp-telegram

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

Созданный с использованием python-telegram-bot, этот сервер позволяет AI-агентам взаимодействовать с Telegram, предоставляя такие функции, как отправка/редактирование/удаление сообщений, загрузка медиафайлов и многое другое, используя официальный Telegram Bot API.

🚀 Начало работы

Предварительные требования

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

Установка

Установите инструмент CLI mcp-telegram:

uv tool install mcp-telegram

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

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

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

mcp-telegram --help # Показать все команды

Вход в систему

Сначала аутентифицируйтесь с помощью токена вашего Telegram бота:

mcp-telegram login

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

• Токен Бота: Получите его от @BotFather в Telegram. Создайте нового бота или выберите существующего, чтобы получить его токен.

[!WARNING] Храните токен вашего бота в секрете и никогда не делитесь им публично.

Подключение к серверу MCP

Чтобы использовать MCP Telegram с клиентами MCP, такими как Claude Desktop или Cursor, вам нужно будет настроить сервер MCP. Процесс настройки зависит от клиента и операционной системы.

Для получения подробных инструкций по настройке, пожалуйста, обратитесь к:

• Claude Desktop MCP Setup Guide
• Cursor MCP Documentation

Файл конфигурации должен содержать:

{
  "mcpServers": {
    "mcp-telegram": {
      "command": "mcp-telegram" /* Используйте полный путь, если клиент не может найти команду (например, "/usr/local/bin/mcp-telegram"). См. раздел ВАЖНО ниже для инструкций по полному пути. */,
      "args": ["start"],
      "env": {
        "BOT_TOKEN": "<your_bot_token>"
      }
    }
  }
}

[!Note] Пути конфигурации различаются в зависимости от ОС и клиента. Например:

• macOS: ~/Library/Application Support/Claude/ или ~/.cursor/
• Windows: %APPDATA%\Claude\ или %APPDATA%\Cursor\

[!IMPORTANT] Если ваш клиент не может выполнить mcp-telegram, несмотря на то, что он доступен в терминале, попробуйте использовать полный путь к исполняемому файлу. Вы можете найти его, запустив which mcp-telegram (macOS/Linux) или where mcp-telegram (Windows) в своем терминале. Замените значение command в конфигурации полным путем.

После сохранения файла конфигурации перезапустите приложение.

🧰 Доступные Инструменты

[!NOTE] Форматирование текста: Все инструменты отправки сообщений поддерживают HTML форматирование. Используйте теги <b>жирный</b>, <i>курсив</i>, <code>код</code>, <a href="ссылка">текст</a> для красивого отображения.

Вот полный список инструментов, которые вы можете использовать для взаимодействия с Telegram через MCP:

📨 Инструменты Обмена Сообщениями

🔍 Поиск и Навигация

📝 Управление Черновиками

📂 Обработка Медиафайлов

[!Note] Для получения подробной информации о параметрах и примерах использования, запустите mcp-telegram tools в вашем терминале.

🛠️ Устранение Неполадок

Если возникли проблемы, убедитесь, что ваш токен бота верен и бот имеет необходимые разрешения в Telegram.

🤝 Внесение Вклада

Мы приветствуем ваш вклад! Если вы хотите помочь улучшить MCP Telegram, пожалуйста, не стесняйтесь отправлять вопросы, запросы функций или запросы на изменение. Ваши отзывы и вклад помогают сделать этот проект лучше для всех.

📝 Лицензия

Этот проект лицензирован в соответствии с лицензией MIT — см. файл для получения подробной информации.