AI导哈

Telegram通知服务

一个简单的MCP服务器，用于将AI代理进度通过Telegram发送给用户。

  • by ParthJadhav
  • TypeScript
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 ParthJadhav/telegram-notify-mcp

使用说明

电报通知MCP

一个极其简单的人 主控程序 具有一个作业的服务器： 在Telegram上向您发送AI代理进度。

就是这样。没有聊天管理，没有群组管理，没有内联查询。只是通知——文本、图像或文件。

你启动一个代理，走开，并在完成时（或工作时）收到一条Telegram消息。没有更多，也没有更少。

快速开始

1.创建Telegram Bot

  1. 消息 @植物学家 在Telegram上
  2. 发送 /newbot 并按照提示进行操作
  3. 复制机器人令牌

2.开始与您的机器人聊天

在Telegram上找到你的机器人并发送 /start。这是必需的，这样机器人才能发现您的聊天ID。

3.添加到您的MCP客户端

克劳德代码

claude mcp add telegram -e TELEGRAM_BOT_TOKEN=your-token -e TELEGRAM_USERNAME=your-username -- npx @parthj/telegram-notify-mcp

克劳德桌面/光标/风帆

添加到MCP配置文件中：

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": ["-y", "@parthj/telegram-notify-mcp"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "your-bot-token",
        "TELEGRAM_USERNAME": "your-telegram-username"
      }
    }
  }
}

配置

环境变量 必填 说明
TELEGRAM_BOT_TOKEN 是 来自的Bot令牌 @植物学家
TELEGRAM_USERNAME 是 您的Telegram用户名（不带@）

工具

三个工具。这就是整个表面积。

send_message

向用户发送文本更新。

参数 类型 必填 说明
text string 是 消息文本
parse_mode string 否 HTML, Markdown，或 MarkdownV2

send_photo

发送图像——屏幕截图、图表、生成的视觉效果。

参数 类型 必填 说明
photo string 是 URL或绝对文件路径
caption string 否 照片说明
parse_mode string 否 标题格式化模式

send_document

发送一个文件——一份报告、一份日志、一个构建工件。

参数 类型 必填 说明
document string 是 URL或绝对文件路径
caption string 否 文档标题
parse_mode string 否 标题格式化模式

运作原理

  • 在第一次调用工具时，服务器通过Telegram Bot API将您的用户名解析为聊天ID getUpdates
  • 发送 /start 需要向机器人发送消息——Telegram机器人只能向发起对话的用户发送消息
  • 聊天ID在进程的生命周期内被缓存

发展

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

许可证

麻省理工学院

相关 MCP