Repolode
提交项目
chigwell

chigwell/telegram-mcp

基于 Telethon 的 MCP 服务器，让 Claude、Cursor 等客户端读取 Telegram 聊天并管理群组、消息、媒体与联系人。

在 GitHub 查看
Star
1,850
Fork
470
未关闭 Issue
31
最近提交
昨天

这是什么？

Telegram MCP Server 是一个 MCP 服务器，可让 Claude Desktop、Cursor 等兼容 MCP 的客户端访问 Telegram 账号、聊天、消息、联系人、媒体、文件夹及管理功能。项目基于 Telethon 实现，提供 80 多个工具，涵盖群组与频道管理、消息的发送、编辑、转发、搜索、投票和表情回应，以及联系人、媒体、资料与隐私设置、文件夹等操作。

服务器支持多账号按标签路由，可限定为只读工具集或聊天白名单。传输方式包括 stdio、streamable HTTP 和 SSE。语音消息转写支持 Groq、Telegram Premium、OpenAI 兼容接口以及本地 faster-whisper 模型。会话可保存为字符串或持久化的 SQLite 文件，并支持 SOCKS、HTTP 和 MTProxy 代理。

由 AI 代理发送或修改消息存在实际风险，因此项目提供只读模式、文件扩展名白名单和文件访问根目录等限制选项。

核心功能

  • 01提供 80 多个 MCP 工具，覆盖聊天、群组、消息、联系人、媒体和文件夹。
  • 02支持多个 Telegram 账号，并按标签路由调用。
  • 03提供只读模式及按工具的白名单，限制写操作。
  • 04可通过 Groq、Telegram Premium、OpenAI 兼容接口或本地 Whisper 转写语音消息。
  • 05支持 stdio、streamable HTTP 和 SSE 传输方式。
  • 06支持 SOCKS、HTTP 和 MTProxy 代理。

适用场景

  • 让 Claude 或 Cursor 汇总未读消息并起草回复。
  • 搜索聊天记录并为 AI 助手提供上下文。
  • 自动化群组管理，如邀请成员、设置权限和封禁用户。
  • 通过 HTTP 让多个编程代理会话共享同一个 Telegram 服务器。

快速上手

  1. 1

    克隆仓库

  2. 2

    使用 uv 安装依赖

    uv sync
  3. 3

    运行服务器

使用前须知

  • 需要 Telegram API ID 和 hash，部分功能需要 Telegram Premium 会员。
  • 多个转录引擎和富文本格式功能依赖付费或需要 API 密钥的服务。

标签

#mcp#telegram#telethon#messaging#chat-management#ai-agent#voice-transcription#admin#api#contacts

常见问题

telegram-mcp 是什么？
基于 Telethon 的 MCP 服务器，让 Claude、Cursor 等客户端读取 Telegram 聊天并管理群组、消息、媒体与联系人。 Telegram MCP Server 是一个 MCP 服务器，可让 Claude Desktop、Cursor 等兼容 MCP 的客户端访问 Telegram 账号、聊天、消息、联系人、媒体、文件夹及管理功能。项目基于 Telethon 实现，提供 80 多个工具，涵盖群组与频道管理、消息的发送、编辑、转发、搜索、投票和表情回应，以及联系人、媒体、资料与隐私设置、文件夹等操作。
telegram-mcp 可以免费使用吗？用的什么许可证？
telegram-mcp 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。
telegram-mcp 还在维护吗？
活跃维护中。telegram-mcp 最近一次提交是在 2026年10月19日。
telegram-mcp 适合用来做什么？
让 Claude 或 Cursor 汇总未读消息并起草回复。 搜索聊天记录并为 AI 助手提供上下文。 自动化群组管理，如邀请成员、设置权限和封禁用户。 通过 HTTP 让多个编程代理会话共享同一个 Telegram 服务器。
telegram-mcp 怎么安装和运行？
克隆仓库 使用 uv 安装依赖: uv sync 运行服务器
在哪里获取 telegram-mcp？
源代码和安装说明在 GitHub 上：https://github.com/chigwell/telegram-mcp

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目