Telegram MCP Server專案

MCP工具

Telegram MCP Server專案

telegram-mcp 是一個功能極其全面的模型內容協定 (Model Context Protocol, MCP) 伺服器，專門用於將您的 AI 助理（如 Claude, Cursor）與您的個人 Telegram 帳號深度整合。此專案基於強大的 Telethon 函式庫開發，旨在將您的 AI 轉變為一個能夠理解自然語言並能全權代您操作 Telegram 的智慧助理。

您可以將其視為賦予了 AI 一雙手，讓它能夠登入您的 Telegram，從而實現從自動收發訊息到管理群組等一系列複雜操作。

核心價值：將 AI 全面融入您的即時通訊

此專案的核心價值在於，它幾乎將 Telegram 的所有主要功能都封裝成了 AI 可以呼叫的工具，徹底打通了大型語言模型與即時通訊軟體之間的壁壘，實現了：

• 對話式操作: 您不再需要手動操作，只需用自然語言對 AI 下達指令，例如：「幫我看看『專案小組』群組的最新訊息」、「傳送『會議延後到三點』給 John Doe」、「把 A 使用者在 B 群組中設為管理員」。
• 資訊自動化整合: AI 可以讀取您的聊天紀錄，進行分析、總結，然後根據結果執行下一步操作，例如「分析一下我和客戶最近的對話，並草擬一封跟進郵件」。
• 強大的自動化能力: 能夠執行複雜的群組管理、聯絡人維護等任務，極大地提升了溝通和社群管理的效率。

主要功能：涵蓋 Telegram 各個層面的龐大工具集

telegram-mcp 提供的工具集幾乎是百科全書式的，涵蓋了 Telegram 的絕大部分功能：

• 聊天與群組管理: 獲取聊天列表、建立/解散群組、編輯群組資訊、管理成員（邀請、踢人、設定管理員）、取得邀請連結等。
• 訊息收發: 讀取歷史訊息、傳送/回覆/編輯/刪除訊息、轉發訊息、釘選訊息等。
• 聯絡人管理: 列出/搜尋/新增/刪除聯絡人、封鎖/解鎖使用者。
• 個人檔案管理: 讀取或更新您自己的個人資料（如姓名、簡介）。
• 搜尋與發現: 在您的聊天中搜尋訊息、搜尋公開的頻道或群組。
• 隱私與設定: 靜音/封存聊天、設定隱私規則。

請注意: 出於 MCP 環境對本地檔案系統存取的限制，一些需要直接處理檔案路徑的功能（如傳送檔案、下載媒體、更換頭像等）已被移除。

如何使用

1. 取得 Telegram API 憑證: 您需要先到 my.telegram.org 申請自己的 API_ID 和 API_HASH。
2. 產生 Session String: 專案內提供了一個腳本 (session_string_generator.py)，執行後會引導您登入 Telegram 帳號，並產生一個授權字串。這個字串相當於您帳號的密碼，極其重要，切勿外洩。
3. 設定環境:
   • 複製此專案，並設定 .env 檔案，填入您的 API 憑證和 Session String。
   • 可以透過本地 Python 環境或使用專案提供的 Docker 映像檔來執行伺服器，後者可以簡化環境依賴問題。
4. 連接 AI 助理: 在您的 AI 助理（如 Claude）的 MCP 設定中，新增此伺服器的設定，指向您在本機運行的 telegram-mcp 服務。

總結來說，telegram-mcp 是一個功能最強大、最完整的 Telegram MCP 整合方案之一。它不僅提供了海量的工具，還在錯誤處理和執行穩定性上做了大量優化，為希望將 AI 能力深度整合到日常通訊中的進階使用者提供了一個無與倫比的強大工具。

• MCP平台來源: github
• 連結: https://github.com/chigwell/telegram-mcp

立即試用MCP工具