Telegram MCP Server Ff8

🚀 Telegram MCP 服務器

Telegram MCP 服務器是一個強大的Telegram集成服務器，提供了多種實用工具。它可以幫助用戶管理聯繫人、發送消息，還能通過MCP（多客戶端協議）檢索頻道信息，極大地提升了用戶在Telegram上的使用體驗。

✨ 主要特性

• 聯繫人管理
  • 獲取聯繫人列表，方便用戶快速查看所有聯繫人。
  • 支持搜索聯繫人，能根據關鍵字迅速定位目標聯繫人。
  • 可查看最近互動，瞭解與聯繫人的最新交流情況。
• 消息功能
  • 可通過姓名或電話號碼向聯繫人發送消息，提供多樣化的發送方式。
  • 能根據日期範圍過濾聊天記錄，便於用戶快速查找特定時間段的聊天信息。
  • 同樣支持查看最近互動，掌握消息動態。
• 頻道功能
  • 能夠獲取頻道帖子，及時瞭解頻道最新內容。
  • 支持搜索頻道，幫助用戶快速找到感興趣的頻道。
  • 可查看頻道信息，瞭解頻道詳情。
  • 能根據日期範圍篩選帖子，精準獲取特定時間的頻道帖子。

📦 安裝指南

先決條件

• Python 3.8 或更高版本
• Node.js 14 或更高版本（用於npx安裝）
• Telegram API憑證（api_id 和 api_hash）
• 一個Telegram賬戶

安裝步驟

1. 克隆倉庫：

git clone https://github.com/yourusername/telegram-MCP-server.git
cd telegram-MCP-server

2. 安裝所需的依賴項：

uv venv .venv  # 創建虛擬環境
source .venv/bin/activate  # 激活（Linux/macOS）
.\venv\Scripts\activate  # 激活（Windows）
uv pip install

3. 在項目根目錄中創建一個.env文件，輸入您的Telegram憑證：

TG_API_ID=your_api_id
TG_API_HASH=your_api_hash
phone=your_phone_number  # 格式：+1234567890

📚 詳細文檔

與Cursor/Claude Desktop集成

複製以下JSON並替換相應的{{PATH}}值：

{
  "mcpServers": {
    "whatsapp": {
      "command": "{{PATH_TO_UV}}", // 運行`which uv`並將輸出放在此處
      "args": [
        "--directory",
        "{{PATH_TO_SRC}}/whatsapp-mcp/whatsapp-mcp-server", // 在repo中運行`pwd`，輸入輸出結果並添加"/whatsapp-mcp-server"
        "run",
        "main.py"
      ]
    }
  }
}

對於Claude，將此文件保存為claude_desktop_config.json，位置在：

~/Library/Application Support/Claude/claude_desktop_config.json

對於Cursor，將此文件保存為mcp.json，位置在：

~/.cursor/mcp.json

工具文檔

get_contacts()

返回所有Telegram聯繫人列表，包括姓名、電話號碼和用戶名。

send_message_by_identifier(identifier: str, message: str)

通過名稱或電話號碼向特定聯繫人發送消息。

• identifier：聯繫人的姓名或電話號碼
• message：要發送的文本消息

get_last_interaction(identifier: str)

返回與特定聯繫人的最近一條消息。

• identifier：聯繫人的姓名或電話號碼

get_chat_history(identifier: str, start_date: str = None, end_date: str = None, limit: int = 20)

在指定的時間範圍內檢索與某個聯繫人的聊天記錄。

• identifier：聯繫人的姓名或電話號碼
• start_date：可選開始日期（YYYY - MM - DD）
• end_date：可選結束日期（YYYY - MM - DD）
• limit：可選限制結果數量

get_posts_by_hashtag(hashtag: str, limit: int = 20)

通過指定的標籤檢索帖子。

• hashtag：要搜索的標籤
• limit：可選限制結果數量

錯誤處理

handle_errors()

處理可能出現的錯誤。

安全考慮

• 確保憑證的安全性，避免洩露。
• 避免在公共網絡上使用此工具。

貢獻指南

如何貢獻

1. Fork 倉庫
2. 創建功能分支
3. 提交更改
4. Push 到分支
5. 創建 Pull Request

貢獻者

• [您的名字] - [您的角色]

📄 許可證

[插入許可證內容]