Tg MCP

🚀 MCP 電報服務器

MCP 電報服務器是一款功能強大的電報服務實現方案，藉助簡潔的 API 接口，為用戶提供消息搜索、發送以及聊天管理等功能，極大提升了電報使用的便捷性與效率。

加入我們的電報討論組，即可參與社區討論，獲取項目支持與最新更新。

🚀 快速開始

在使用 MCP 電報服務器之前，您需要滿足以下先決條件：

• Python 3.x
• 電報 API 憑證（API ID，API Hash）
• MCP 兼容環境（如 Cursor IDE）

✨ 主要特性

• 多模式消息搜索：
  • 基本文本搜索：可快速定位包含特定文本的消息。
  • 帶有自定義過濾器的高級搜索：支持根據多種條件篩選消息。
  • 使用正則表達式的基於模式的搜索：滿足複雜的消息查找需求。
• 聊天管理：
  • 列出可用對話：方便用戶查看所有聊天會話。
  • 發送帶有可選回覆支持的消息：支持對特定消息進行回覆。
  • 生成消息鏈接：便於分享特定消息。
• 分析和數據：
  • 聊天統計信息和分析：深入瞭解聊天數據。
  • 聊天數據導出功能：方便用戶備份和處理聊天數據。
• 強大的錯誤處理和日誌記錄：確保系統穩定運行，便於排查問題。
• 基於 MCP（模型控制協議）架構構建：具備良好的擴展性和兼容性。

📦 安裝指南

1. 克隆倉庫並進入項目目錄：

git clone https://github.com/leshchenko1979/tg_mcp.git
cd tg_mcp

2. 安裝依賴項：

pip install -r requirements.txt

3. 在根目錄下創建一個.env文件，包含您的電報憑證：

API_ID=your_api_id
API_HASH=your_api_hash
PHONE_NUMBER=+123456789

4. 運行設置腳本來與電報認證：

python setup_telegram.py

這將創建一個會話文件（mcp_telegram_search.session），其中存儲您的電報會話數據。

📚 詳細文檔

Cursor配置

要將此服務器與 Cursor IDE 一起使用：

1. 在.cursor目錄中創建一個mcp.json文件，內容如下：

{
  "mcpServers": {
    "telegram_server": {
      "type": "local",
      "config": {
        "env_file": ".env"
      }
    }
  }
}

2. 啟動 Cursor 並連接到新的 MCP 服務器。

使用說明

計算消息哈希

mcp TelegramServer \
    --hash "Hello, World!"

批量處理聊天記錄

for message in $(seq 1 100); do
    mcp TelegramServer \
        --send "Message $message"
done

項目結構

項目目錄/
├── setup_telegram.py         # 電報設置腳本
├── requirements.txt          # 項目依賴項
├── .env                      # 環境變量（創建此文件）
├── logs/                    # 日誌文件目錄
├── LICENSE                 # MIT 許可證
└── src/
    ├── server.py            # 主服務器邏輯
    └── utils.py           # 輔助函數和工具

注意：在認證後會生成*.session 和 *.session-journal 文件

依賴項

項目依賴以下主要包：

loguru          # 日誌記錄
aiohttp         # 異步 HTTP
mcp[cli]        # 模型控制協議
telethon>=1.34.0  # 電報客戶端
python-dotenv>=1.0.0  # 環境管理

📄 許可證

此項目根據 MIT 許可證發佈，詳細信息請參閱LICENSE文件。