chigwell/telegram-mcp

解决的问题

该项目为 AI 代理（如 Claude、Cursor 及其他 MCP 兼容客户端）与 Telegram 之间提供桥梁。它允许 LLM 与您的 Telegram 账户交互，实现读取和发送消息、管理聊天、处理媒体，从而将您的 Telegram 账户变成 AI 代理的工具。

工作原理

它实现了 Model Context Protocol (MCP)，向 AI 代理公开了 80 多个工具。使用 Telethon 库与 Telegram API 通信。服务器可通过 Python 或 Docker 本地运行，支持三种传输方式：stdio、streamable HTTP 和 SSE。它包含安全层，可限制暴露的工具（例如只读模式），并强制执行严格的文件路径安全策略，防止未经授权的文件访问。

适用人群

希望将 Telegram 通信集成到 AI 工作流中的 MCP 兼容 AI 代理用户，以及希望赋予 AI 助手管理 Telegram 账户和消息能力的开发者。

主要亮点

• 丰富的工具集： 提供 80 多个工具，用于管理账户、聊天、消息、联系人、媒体和文件夹。
• 多账户支持： 可配置并路由多个 Telegram 账户之间的工具调用。
• 联系人别名： 一种系统，可“记住”联系人的自定义名称，使代理交互更自然。
• 灵活的传输方式： 支持 stdio、http 和 sse，便于多个客户端共享服务器。
• 细粒度安全控制： 可选择将工具限制为只读，或仅允许特定写入工具列表。
• 实时事件： 提供传入事件流，用于回调式交付（特别适用于 Claude Code）。
• 代理支持： 内置对 SOCKS、HTTP 和 MTProxy 的支持。