telegram-notify-mcp

Telegram Notify MCP

一款极简的 MCP 服务，只做一件事：通过 Telegram 向你发送 AI Agent 的进度。

就是这样。没有聊天管理、群组管理或内联查询。只有通知——以文本、图片或文件的形式发送。

启动 Agent 后，你可以离开，等它完成（或在运行过程中）收到 Telegram 消息。不多不少，恰到好处。

快速开始

1. 创建 Telegram 机器人

1. 在 Telegram 上给 @BotFather 发消息
2. 发送 /newbot 并按提示操作
3. 复制机器人令牌

2. 与机器人开始聊天

在 Telegram 上找到你的机器人并发送 /start。这是机器人获取你的聊天 ID 所必需的。

3. 添加到 MCP 客户端

Claude Code

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

Claude Desktop / Cursor / Windsurf

添加到你的 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	是	来自 @BotFather 的机器人令牌
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 的 getUpdates 将你的用户名解析为聊天 ID
• 必须向机器人发送 /start——Telegram 机器人只能向主动发起对话的用户发送消息
• 聊天 ID 会在进程运行期间缓存

开发

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

许可证

MIT