Telegram MCP Server 65w

Telegram MCP服務器是一個基於Node.js的服務，允許LLM通過Telegram發送通知並接收用戶響應，支持與Cline等MCP兼容應用集成。

人工智能聊天機器人通信工具 #Telegram通知 #LLM交互 #消息響應 #MCP協議本地 .JavaScript

評分 : 2.5分

下載量 : 14

更新時間 : 2025-04-23

什麼是Telegram MCP Server?

Telegram MCP Server是一個基於Model Context Protocol的服務器，允許大型語言模型(LLM)通過Telegram發送通知並與用戶進行交互。它充當LLM應用和Telegram之間的橋樑，實現雙向通信。

如何使用Telegram MCP Server?

您可以通過npm全局安裝或從GitHub克隆項目來使用。配置Telegram機器人和聊天ID後，即可開始接收LLM通知並回復。

適用場景

適用於需要LLM主動通知用戶並獲取反饋的場景，如任務確認、權限請求、重要提醒等交互式AI應用。

主要功能

Telegram通知推送支持向指定Telegram聊天發送文本通知，並可設置不同緊急級別(low/medium/high)

用戶響應處理能夠等待和檢索用戶對通知的回覆，實現雙向交互

多平臺集成支持與Cline、Claude Desktop等MCP兼容的LLM應用集成

優勢與侷限性

優勢

利用Telegram的廣泛普及性，用戶無需額外安裝應用

支持靈活的通知優先級設置

開源且易於擴展

侷限性

需要用戶擁有Telegram賬號

需自行配置Telegram機器人和獲取Chat ID

目前僅支持文本交互

如何使用

獲取Telegram機器人Token

通過與@BotFather對話創建新機器人並獲取訪問Token

獲取Chat ID

向機器人發送消息後，通過API獲取包含Chat ID的響應

安裝服務器

通過npm全局安裝或從GitHub克隆項目

配置環境變量

設置TELEGRAM_BOT_TOKEN和TELEGRAM_CHAT_ID環境變量

啟動服務器

運行telegram-mcp命令啟動服務器

使用案例

項目狀態確認當LLM完成重要任務時發送確認請求

權限請求需要用戶授權訪問特定資源時

常見問題

如何找到我的Chat ID?

通知沒有送達怎麼辦?

支持群組聊天嗎?

🚀 Telegram MCP 服務器

Telegram MCP 服務器是一個模型上下文協議（MCP）服務器，它能讓大語言模型藉助 Telegram 發送通知，並接收用戶的響應，為信息交互提供了便捷的途徑。

🚀 快速開始

Telegram MCP 服務器允許大語言模型通過 Telegram 與用戶進行交互。在使用前，請確保滿足以下先決條件，並完成相應的安裝和配置。

✨ 主要特性

可向 Telegram 聊天發送文字通知，且緊急程度可自定義。
能夠等待並檢索用戶的回應。
可與 Cline 和其他 MCP 兼容的 LLM 應用程序集成。

📦 安裝指南

通過 npm（推薦）

npm install -g telegram-mcp

通過 GitHub

git clone https://github.com/CHarrisTech/telegram-mcp.git
cd telegram-mcp
npm install
npm run build

🛠️ 配置說明

服務器需要配置以下兩個環境變量：

TELEGRAM_BOT_TOKEN：您的 Telegram 機器人令牌。
TELEGRAM_CHAT_ID：您的 Telegram 聊天 ID。

獲取 Telegram 機器人令牌

在 Telegram 上與 @BotFather 開始對話。
發送命令 /newbot。
按照指示創建一個新的機器人。
BotFather 將為您提供新的機器人令牌。

查找您的聊天 ID

與新機器人開始對話。
向機器人發送一條消息。
訪問 https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates。
在響應中查找 chat 對象並記錄 id 字段。

💻 使用示例

單獨運行

# 設置環境變量
export TELEGRAM_BOT_TOKEN="your_bot_token"
export TELEGRAM_CHAT_ID="your_chat_id"

# 運行服務器
telegram-mcp

與 Cline 集成

在您的 Cline MCP 設置文件中添加以下內容：

{
    "botToken": "your_bot_token",
    "chatId": "your_chat_id"
}

然後運行命令：

clarity run mcp-telegram-config.js

與 Clarice Desktop 集成

在您的 Clarice Desktop 設置文件中添加以下內容：

{
    "botToken": "your_bot_token",
    "chatId": "your_chat_id"
}

然後運行命令：

claride run mcp-telegram-config.js

可用工具

發送通知

curl -X POST http://localhost:1234/send-notification \
  -H "Content-Type: application/json" \
  -d '{"message": "示例消息"}'

檢查通知狀態

curl -X GET http://localhost:1234/check-notifications

🛠️ 開發指南

克隆倉庫

git clone https://github.com/CHarrisTech/telegram-mcp.git
cd telegram-mcp

安裝依賴項

npm install

構建項目

npm run build

🧪 測試腳本示例

Linux/MacOS

創建 test.sh 文件：

#!/bin/bash
set -e

# 設置變量
BOT_TOKEN="your_bot_token"
CHAT_ID="your_chat_id"

# 發送通知
curl -X POST http://localhost:1234/send-notification \
  -H "Content-Type: application/json" \
  -d '{"message": "測試消息"}'

# 檢查通知狀態
curl -X GET http://localhost:1234/check-notifications

然後運行：

chmod +x test.sh
./test.sh

Windows

創建 test.bat 文件：

@echo off
set BOT_TOKEN=your_bot_token
set CHAT_ID=your_chat_id

curl -X POST http://localhost:1234/send-notification ^
  -H "Content-Type: application/json" ^
  -d '{"message": "測試消息"}'

curl -X GET http://localhost:1234/check-notifications

然後運行：

test.bat

🌟 示例

程序示例

創建 example.js 文件：

const TelegramMCP = require('telegram-mcp');

// 初始化服務器
const server = new TelegramMCP({
    botToken: 'your_bot_token',
    chatId: 'your_chat_id'
});

// 發送消息
server.sendNotification("這是一個測試消息。");