telegram-mcp
活跃·★ 1.9k·Apache-2.0·更新于 2026-10-21
★ 时下流行
telegram-mcp 通过 Telethon 把 MCP 客户端连接到 Telegram 用户账号，提供 80 多个工具，涵盖账号、聊天与群组、消息、联系人、媒体、文件夹和管理操作。助手可以读取和总结聊天、搜索历史、管理群组，以及发送或编辑消息。
配置需要从 my.telegram.org 获取 Telegram API 凭据，再生成一个 session string，仓库里的脚本支持用手机号或二维码生成。服务可以从源码用 uv 运行，也可以用 Docker，支持多账号、代理和设备身份设置。
有几项设计用来限制智能体误操作：聊天白名单、文件路径限制、预期账号检查，以及联系人别名——只有精确匹配已保存的名称才会发送，相似名称只会给出建议。项目还附带工作流指南，比如只起草回复而不发送。
#管理#API#聊天管理#联系人#群组#MCP#MCP 服务器#媒体
01
功能特性
0180 多个 MCP 工具，覆盖聊天、群组、消息、联系人、媒体、文件夹与管理
02发送、定时、编辑、转发、置顶、搜索消息，管理投票和表情回应
03多账号路由与代理支持
04聊天访问白名单和文件路径限制，使用更安全
05联系人别名：只有精确匹配才发送，相似名称只给出建议
02
为什么选择它
+覆盖面广：80 多个工具，涵盖聊天、群组、消息、联系人、媒体、文件夹和管理任务。
+聊天白名单、文件路径限制和精确匹配的联系人别名等安全控制，降低消息发错对象的风险。
+支持多账号路由、代理，也可以用 Docker 作为服务运行。
03
权衡点
!它以你本人的用户账号身份操作，智能体出错可能发送、编辑或删除真实消息，需要认真配置白名单。
!配置需要 API 凭据和生成 session string，比托管式集成麻烦。
!富文本格式模式需要账号开通 Telegram Premium。
04
维护状况检查
活跃检查日期: 2026-10-22
- 最近提交
- 2026-10-21
- 近 90 天提交数
- 100+
- 近 90 天发布数
- 30
- 最新发布
- v3.2.97 (2026-10-21)
- 未关闭 issue
- 38
- 近期 issue 至少有一条评论的比例
- 1/7
近 12 周每周提交数
最早的一周在左边，最近 4 周为橙色。数据来源：GitHub 提交统计。
状态规则：GitHub 上已归档 = 已归档；最近提交在 90 天内 = 活跃；91 到 365 天 = 放缓；更久 = 停滞。所有数字来自所示日期的 GitHub API。
讨论最多的未关闭 issue
- #317 Question: outgoing messages disappeared across multiple private chats2 条评论 · 2026-10-16
- #56 mcp configuration for codker2 条评论 · 2026-01-29
- #116 Feature request: Per-chat read/write allowlists with web-based configuration UI1 条评论 · 2026-05-02
- #359 Cancelled tool calls still get a "Request cancelled" reply, which breaks the stdio connection in Claude Code0 条评论 · 2026-10-22
- #355 send_file: videos arrive squashed into a square, with 0:00 duration and no preview0 条评论 · 2026-10-22
issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。
05
兼容性
Claude Desktop
MCP
已通过文档验证
Cursor
MCP
已通过文档验证
Docker
Docker 镜像
已通过文档验证
06
快速开始
1
$ git clone https://github.com/chigwell/telegram-mcp.git
2
$ cd telegram-mcp
3
$ uv sync
4
$ uv run session_string_generator.py
07
使用场景
↳用 Claude 总结 Telegram 未读消息
↳起草回复供审阅，暂不发送
↳通过 AI 助手管理 Telegram 群组和频道
08
同类工具
评论
登录后发表评论
暂无评论，来发表第一条吧