{"repo":"runesleo/tg-reader-mcp","free":true,"listed":false,"github":"https://github.com/runesleo/tg-reader-mcp","clone":"git clone https://github.com/runesleo/tg-reader-mcp.git","description":"Telegram channel and group reader MCP Server","language":"Python","stars":35,"topics":["ai-agents","mcp","mcp-server","python","telegram"],"license":"MIT","category":"mcp-servers","readme_excerpt":"tg-reader-mcp 中文： 只读 Telegram MCP：用你本机已登录的账号，让 AI 读频道、群、私聊与联系人卡片；不发消息、不改记录、不删内容（仅提供 mark read 清未读）。 English: README.en.md --- Quick Start 1. 安装 2. 准备 Telethon session 需要本机有一份已授权的 .session （userbot 登录，非 Bot Token）。最小示例： 默认 API ID / API HASH 与 Telegram Desktop 公开凭据一致。若要自建应用，在 my.telegram.org 申请并设置环境变量 TG API ID 、 TG API HASH 。 3. Claude Desktop（ claude desktop config.json ） 将下面 mcpServers 里的键值对 合并进你现有配置文件的 mcpServers 对象中（路径示例：macOS /Library/Application Support/Claude/claude desktop config.json ）。把占位路径换成你的绝对路径。 可选环境变量： TG API ID 、 TG API HASH （覆盖默认 Telegram Desktop 凭据）。 4. Claude Code（CLI） --- Tools（与源码一致） 以下名称与 server.py 中 @server.list tools() 注册项一一对应。 list dialogs - 用途： 列出对话（频道 / 群 / 私聊），支持组合过滤与关键词。 - 参数： - filter （可选）：如 unread 、 unread dm 、 unread channel 、 channel 、 group 、 dm 等组合；否则按对话标题 / username 子串匹配。 - limit （可选，默认 50 ）：最多返回条数。 - 示例： read channel - 用途： 读取指定频道或群的近期文本消息。 - 参数： - channel （必填）：username（如 durov ）或可被 Telethon 解析的标题。 - limit （可选，默认 20 ，上限 100 ）。 - since （可选）：ISO 8601 时间，仅返回 严格晚于 该时间的消息。 - offset date （可选）：ISO 时间，从该时刻 向前翻页 （配合返回的 next offset date ）。 - 示例： search channel - 用途： 在 单个 频道/群内按关键词搜索消息。 - 参数： - channel （必填） - keyword （必填） - limit （可选，默认 20 ） - 示例： mark read - 用途： 将某对话标为已读（清未读角标）。 - 参数： - channel （必填）：频道、群或私聊标识（username 或标题）。 - 示例： get contact - 用途： 查询 单个用户 的联系级信息（含 bio、共同群数量、 last seen 等）。 note 为你在官方客户端里写的 仅自己可见 的联系人备注（需对方已是联系人等条件才有电话/备注等字段）。 - 参数： - username （必填）：不带 @ 的 username 或数字 user id。 - 示例： list contacts matching - 用途： 扫描私聊对话，找出 first name / la","default_branch":null,"files":null,"tree":[],"storefront":"/r/runesleo","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/runesleo/tg-reader-mcp/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}