MCP提交

Telegram MCP Server 65w

Telegram MCP服务器是一个基于Node.js的服务，允许LLM通过Telegram发送通知并接收用户响应，支持与Cline等MCP兼容应用集成。

人工智能聊天机器人通信工具 #Telegram通知 #LLM交互 #消息响应 #MCP协议本地 .JavaScript

2.5分

2025-04-23 12:43:09

概述

安装

工具列表

内容详情

替代品

什么是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?向您的机器人发送消息后，访问https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates，在响应中查找chat对象的id字段

通知没有送达怎么办?1. 确认机器人已加入聊天 2. 检查Token和Chat ID是否正确 3. 确保机器人未被用户屏蔽

支持群组聊天吗?目前主要设计用于私聊，群组聊天可能需要额外配置

Telegram MCP 服务器

一个模型上下文协议（MCP）服务器，允许大语言模型通过 Telegram 发送通知并与用户接收响应。

功能

向 Telegram 聊天发送带有可自定义紧急程度的文字通知
等待并检索用户的回应
集成与 Cline 和其他 MCP 兼容的 LLM 应用程序

先决条件

Node.js 16 或更高版本
您的 Telegram 机器人令牌（从 @BotFather 获得）
您的 Telegram 聊天 ID

安装

通过 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("这是一个测试消息。");