skrudjreal/telegram-mcp

Developer tools

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

5 stars 3 forks Качество 73 Тренд 13Apache-2.0

Repository Install

Telegram MTProto MCP server with watcher, context builder, criminal & personality analysis

Обзор

Here's a demonstration of the Telegram MCP capabilities in Claude: As you can see, the AI can seamlessly interact with your Telegram account, retrieving and displaying your chats, messages, and other data in a natural way. A full-featured Telegram integration for Claude, Cursor, and any MCP-compatible client, powered by Telethon and the Model Context Protocol (MCP). This project lets you interact with your Telegram account programmatically, automating everything from messaging to group management. This MCP server exposes a huge suite of Telegram tools.

README

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

🤖 MCP in Action

Here’s a demonstration of the Telegram MCP capabilities in Claude:

Basic usage example:

Example: Asking Claude to analyze chat history and send a response:

Successfully sent message to the group:

As you can see, the AI can seamlessly interact with your Telegram account, retrieving and displaying your chats, messages, and other data in a natural way.

A full-featured Telegram integration for Claude, Cursor, and any MCP-compatible client, powered by Telethon and the Model Context Protocol (MCP). This project lets you interact with your Telegram account programmatically, automating everything from messaging to group management.

🚀 Features & Tools

This MCP server exposes a huge suite of Telegram tools. Every major Telegram/Telethon feature is available as a tool!

Chat & Group Management

get_chats(page, page_size): Paginated list of chats
list_chats(chat_type, limit): List chats with metadata and filtering
get_chat(chat_id): Detailed info about a chat
create_group(title, user_ids): Create a new group
invite_to_group(group_id, user_ids): Invite users to a group or channel
create_channel(title, about, megagroup): Create a channel or supergroup
edit_chat_title(chat_id, title): Change chat/group/channel title
delete_chat_photo(chat_id): Remove chat/group/channel photo
leave_chat(chat_id): Leave a group or channel
get_participants(chat_id): List all participants
get_admins(chat_id): List all admins
get_banned_users(chat_id): List all banned users
promote_admin(chat_id, user_id): Promote user to admin
demote_admin(chat_id, user_id): Demote admin to user
ban_user(chat_id, user_id): Ban user
unban_user(chat_id, user_id): Unban user

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

Установка

docker run -it --rm \

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

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

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/full/path/to/telegram-mcp",
        "run",
        "main.py"
      ]
    }
  }
}