Telegram MCP Server 65w

🚀 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 機器人令牌

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

查找您的聊天 ID

1. 與新機器人開始對話。
2. 向機器人發送一條消息。
3. 訪問 https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates。
4. 在響應中查找 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("這是一個測試消息。");

然後運行：

node example.js

📄 許可證

本項目採用 MIT 許可證。