chigwell/telegram-mcp

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

1,9 тыс. stars 486 forks Качество 90 Тренд 56Apache-2.0

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

Обзор

Интеграция с Telegram для Claude, Cursor и других совместимых с MCP клиентов. Она предоставляет операции аккаунта Telegram, чат, сообщения, контакты, медиафайлы, папки и администратора через протокол Model Context с использованием Telethon. Попросив Клода проанализировать историю чата и отправить ответ: В настоящее время сервер включает 80+ инструментов MCP, сгруппированных по следующим зонам: - перечислять настроенные аккаунты и маршрутизировать вызовы инструментов по метке аккаунта. - переписывать чаты, проверять метаданные, создавать группы/каналы, присоединяться или уходить из чатов, приглашать пользователей, управлять администраторами, банами, правами по умолчанию, режимом медленного замедления, темами, ссылками на приглашения, обычными чатами, уведомлениями о прочтении и ссылками на сообщения. - отправлять, планировать, редактировать, удалять, пересылать, закреплять, откреплять, отмечать прочитанное, ответить, искать, проверять контекст, создавать опросы, управлять реакциями, проверять встроенные кнопки и нажимать входящие вызовы. - перечислять, искать, добавлять, удалять, блокировать, разблокировать, импортировать, экспортировать, проверять прямые чаты и находить недавние контакты.

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

🤖 MCP в действии

Основное использование MCP в Telegram в Claude:

Попросив Клода проанализировать историю чата и отправить ответ:

Сообщение успешно отправлено:

Содержание

Навыки и практические рабочие процессы
Что он может сделать
Требования
Быстрый старт
Конфигурация клиента MCP
Настройка нескольких аккаунтов
Идентификатор устройства
Проверка ожидаемого счета
Поддержка прокси
Безопасность пути файлов
Приватность доступа к чату (Allowlist)
Docker
Разработка
Примечания по безопасности
Устранение неисправностей
Лицензия

Навыки и рабочие процессы

Ищете готовые к использованию рабочие процессы, примеры подсказок или рецепты интеграции? Ознакомьтесь с Документацией по навыкам для пошаговых руководств по следующим направлениям:

Безопасное суммирование непрочитанных сообщений
Составление ответов без отправки
Сортировка задач и срочных запросов
Поиск в истории чатов и расширение контекста

Что он может сделать

В настоящее время сервер включает 80+ инструментов MCP, сгруппированных по следующим зонам:

Аккаунты: перечисляют настроенные аккаунты и маршрутизируют вызовы инструментов по метке аккаунта.

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

README

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

A Telegram integration for Claude, Cursor, and other MCP-compatible clients. It exposes Telegram account, chat, message, contact, media, folder, and admin operations through the Model Context Protocol using Telethon.

🤖 MCP in Action

Basic Telegram MCP usage in Claude:

Asking Claude to analyze chat history and send a response:

Message sent successfully:

Skills & Practical Workflows
What It Can Do
Requirements
Quick Start
MCP Client Configuration
Multi-Account Setup
Device Identity
Expected Account Check
Proxy Support
File Path Security
Chat Access Privacy (Allowlist)
Docker
Development
Security Notes
Troubleshooting
License

Skills & Workflows

Looking for ready-to-use workflows, prompt examples, or integration recipes? Explore the Skills Documentation for step-by-step guides on:

What It Can Do

The server currently includes 80+ MCP tools grouped into these areas:

Accounts: list configured accounts and route tool calls by account label.

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

Установка

npx -y mcp-remote http://127.0.0.1:8765/mcp

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

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

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/full/path/to/telegram-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "TELEGRAM_API_ID": "your_api_id_here",
        "TELEGRAM_API_HASH": "your_api_hash_here",
        "TELEGRAM_SESSION_STRING": "your_session_string_here"
      }
    }
  }
}