fast-mcp-telegram

用途

fast-mcp-telegram 是面向 AI 智能体的 Telegram MCP 网关，充当 AI 智能体与 Telegram API 之间的中间层。它解决的核心问题是：Telegram 原生 API 接口繁多且零散，AI 智能体难以直接高效调用；该网关将 80 多个微 API 整合为 8 个对 AI 友好的工具，让 AI 助手能够以更自然的方式操作 Telegram。

主要能力

• 认证方式：支持通过 Telegram 移动端扫描二维码完成认证（设置 → 设备 → 扫描二维码），无需输入手机号、无需 OTP、无需 2FA；也支持以手机号作为备选方式，或使用 Bot Token（无需手机号与 OTP）。
• 工具集：暴露 8 个上下文高效的工具，替代 80 多个微 API。
• 多租户：一个服务器可服务多个用户，会话相互隔离。
• 传输模式：支持 HTTP 与 stdio 两种传输方式。
• MTProto 桥接：为高级用户提供原始 MTProto 直接访问能力，可通过 curl 调用。
• 文件与语音：支持文件附件与语音转写。

使用方式

1. 安装与认证
   • 远程服务器快捷路径：打开 https://tg-mcp.l1979.ru/setup → 扫描二维码 → 复制 Bearer token。
   • 本地 CLI 路径（stdio）：运行 fast-mcp-telegram-setup 一次以创建 Telegram 会话，然后由 fast-mcp-telegram 提供服务。
   • Bot Token 替代方案：设置 BOT_API_TOKEN 环境变量，替代 --phone-number 参数。
2. 配置 MCP 客户端
   • stdio 模式（本地）：将服务器添加到 MCP 客户端配置（如 claude_desktop_config.json）。stdio 是本地 MCP 客户端的默认传输方式。
   • http-auth 模式（远程）：将服务器添加到 MCP 客户端配置，token 通过扫描设置页面的二维码获取。
3. 直接 API 调用（curl）：可使用 curl 命令直接调用，需替换为自己的 TOKEN。
4. 部署到远程服务器：可在 VDS 上部署自己的 MCP 服务器，具体步骤参见安装指南。

适用场景

• 让 AI 助手通过 MCP 协议操作 Telegram，例如向自己的收藏消息发送问候。
• 需要多用户共享同一 Telegram 网关服务的场景。
• 需要直接调用 MTProto 原始 API 的高级用户。
• 需要处理 Telegram 文件附件与语音转写的场景。

限制与说明

• 匿名工具遥测自 v0.30.1 起启用：每 6 小时发送一次心跳，不收集凭据或消息内容，可通过 DO_NOT_TRACK=1 退出。
• 认证流程遥测自 v0.38.0 起启用：在设置过程中（手机号、二维码、Bot Token、重新授权）记录原子事件，流程完成时缓冲刷新。
• 采用 MIT 许可证。
• 具体工具清单与详细文档参见 Tools Reference；本地安装与远程部署参见 Installation Guide；安全特性参见 Security 文档。