电报通知MCP
](https://www.npmjs.com/package/@parthj/telegram-notify-mcp) 
一个极其简单的人 主控程序 具有一个作业的服务器： 在Telegram上向您发送AI代理进度。
就是这样。没有聊天管理，没有群组管理，没有内联查询。只是通知——文本、图像或文件。
你启动一个代理，走开，并在完成时（或工作时）收到一条Telegram消息。没有更多，也没有更少。
快速开始
1.创建Telegram Bot
- 消息 @植物学家 在Telegram上
- 发送
/newbot并按照提示进行操作 - 复制机器人令牌
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许可证
麻省理工学院