aichishutiao/telegram-mcp repository overview

⁠Telegram Account MCP

Telegram Account MCP 是一个自托管 MCP 服务，用来把个人 Telegram 账号封装成 AI agent 可调用的工具。

部署完成后，OpenClaw、Claude Desktop、Codex 或其他支持 MCP 的客户端，可以通过标准 MCP 协议读取 Telegram 会话、搜索消息、查看联系人，并执行发送、转发、编辑、删除、置顶、标记已读、创建群组、退出群组等操作。

本项目使用 Telegram 官方 MTProto API，也就是 my.telegram.org/apps 中创建的 api_id 和 api_hash。它不是 Telegram Bot API：Bot API 操作的是机器人账号，而本项目操作的是已登录的 Telegram 个人账号。

⁠主要功能

• 将个人 Telegram 账号暴露为 MCP 工具
• 支持 HTTP MCP：http://localhost:18070/mcp
• 支持 stdio MCP，适合本地 MCP 客户端
• 支持 Docker 部署
• 使用 PostgreSQL 保存加密后的 Telegram session
• 查看当前登录账号
• 列出私聊、群组、超级群、频道
• 读取指定会话的最近消息
• 搜索 Telegram 历史消息
• 查看联系人、文件夹、会话详情、用户详情
• 发送消息、回复消息
• 转发消息
• 编辑消息
• 删除消息
• 置顶 / 取消置顶消息
• 标记会话已读
• 创建群组
• 退出群组或频道

⁠快速开始

拉取镜像：

docker pull aichishutiao/telegram-mcp:latest