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。