Telegram MCP

Telegram MCP 是面向 Claude、Cursor 及其他 MCP 兼容客户端的 Telegram 集成服务。基于 Telethon 库，通过 Model Context Protocol (MCP) 暴露 Telegram 账户、聊天、消息、联系人、媒体、文件夹和群组管理等80+项操作能力。

核心功能

• 消息管理：发送、定时、编辑、删除、转发、置顶/取消置顶、标记已读、回复、搜索、创建投票、管理反应、内联按钮交互
• 聊天与群组：列出聊天、查看元数据、创建群组/频道、加入/离开、邀请用户、管理管理员/封禁/权限/慢速模式/话题/邀请链接
• 媒体操作：发送文件、下载媒体、上传文件、发送语音/贴纸/GIF、检查消息媒体
• 多账户与安全：支持多账户配置和会话池、只读模式工具暴露控制、代理支持(SOCKS5/HTTP/MTProxy)、文件路径安全沙箱
• 三种传输协议：stdio(默认)、streamable HTTP(共享服务)、SSE(遗留)

适用场景

• AI 代理通过自然语言操作 Telegram 发送/分析消息
• 聊天记录分析与自动回复，智能客服机器人
• 多 Telegram 账户统一管理和批量操作
• 通过共享 HTTP 端点为多个 MCP 客户端(Claude Code/Codex/Cursor)提供 Telegram 能力
• 自动化 Telegram 群组/频道管理，定时发布内容
• 消息监控和数据分析

安装方式

注意：切勿使用 pip install telegram-mcp 或 uvx telegram-mcp（PyPI 上同名包为其他项目）

# 从源码安装
git clone https://github.com/chigwell/telegram-mcp.git
cd telegram-mcp
uv sync

# 生成会话字符串（扫码登录）
uv run session_string_generator.py --qr

# 配置环境变量
cp .env.example .env
# 编辑 .env 填入 TELEGRAM_API_ID、API_HASH、SESSION_STRING

# 启动服务器
uv run main.py

MCP 客户端配置：

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

许可证：MIT