MCP Telegram Poc

🚀 MCP 集成示例與 Telegram 的結合使用

本項目是一個基於 Python 的模型上下文協議（MCP）客戶端和服務器，它能讓大語言模型（LLM）通過 Telegram 發送通知，並接收用戶的回覆，為信息交互提供了便利。

✨ 主要特性

• 可向 Telegram 聊天發送帶有可自定義優先級級別的文本警報，滿足多樣化的通知需求。
• 能夠檢查用戶回覆，並可配置超時時間，確保信息交互的及時性和有效性。
• 擁有靈活的模板，支持與 MCP 兼容的 LLM 應用程序集成，便於拓展和使用。

📚 詳細文檔

MCP 與函數調用或代理工具的對比

MCP 協議（模型上下文協議）

• 將 LLM 的推理（“上下文”）與其外部操作的執行分離。例如，LLM 決定要採取什麼行動，而 MCP 服務器處理如何執行該操作。
• 這種解耦意味著您可以更新或更換外部工具而不更改核心 LLM 模型或其提示。
• 它還允許以更安全和受控的方式執行操作。

LLM 函數調用或代理

• 直接函數調用或基於代理的方法通常將決策制定與執行邏輯混合在一起，這可能會使系統模塊化程度較低。
• 變更操作執行方式可能需要重構代理或修改 LLM 的提示，從而使維護變得更加困難。

📦 安裝指南

先決條件

• 需要 Python 3.11+ 版本。
• 準備好 Telegram 機器人令牌（可從 @BotFather 獲取）。
• 準備好您的 Telegram 聊天 ID。

安裝步驟

1. 克隆倉庫：

   git git@github.com:arananet/mcp-telegram-poc.git
   cd mcp-telegram-poc
   

2. 安裝依賴項：

   pip install -r requirements.txt
   

3. 創建虛擬環境：

   python3 -m venv .venv
   

4. 複製 .env.example 到 .env 並填寫您的 Telegram 憑據：

   cp .env.example .env
   nano .env
   

🛠️ 配置

編輯 .env 文件，填入以下內容：

• TELEGRAM_BOT_TOKEN= 您的機器人令牌
• TELEGRAM_CHAT_ID= 您的聊天 ID
• OPENAI_API_KEY= 您的 OpenAI API 密鑰

獲取 Telegram 機器人令牌

1. 在 Telegram 上與 @BotFather 聊天。
2. 發送 /newbot，並提供一個名稱（例如 mcp_example），然後提供一個用戶名（例如 mcp_example_bot）。此時 BotFather 會回覆您的令牌。
3. 複製提供的令牌。

獲取您的聊天 ID

1. 向您的機器人發送消息（前往創建的機器人頁面，發送一條示例消息，例如 hi）。
2. 訪問 https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates。
3. 查找 chat 對象的 id 字段。您會看到類似的內容（例如 "chat":{"id": "<您的聊天 ID>", ...}）。提取 <您的聊天 ID>。

💻 使用示例

基礎用法

• 運行服務器：

  python3 -m mcp_server
  

• 發送警報：

  python3 -c "from mcp_client import send_alert; send_alert('這是一個測試警報！')"
  

工具使用示例

send_alert

向 Telegram 聊天發送警報。

from mcp_client import send_alert

send_alert("系統檢測到異常情況，請注意！")

check_reply

檢查用戶對消息的回覆。

from mcp_client import check_reply

# 假設消息 ID 為 123
reply = check_reply(123, timeout=60)
print(reply)

📄 開發信息

• 項目文檔：MCP 與 Telegram 集成
• 問題反饋：可在 GitHub Issues 提交錯誤或建議。
• 許可協議：本項目基於 MIT 許可證。