电报MCP桥
 
Claude Code的Telegram MCP桥——通过Telegram获取通知、提问并与您的Claude Code会话交互。
每个Claude Code会话在Telegram组中都有自己的线程（主题），因此您可以一次监视多个会话。
特性
- 发送消息 --进度更新、最终报告、通知
- 询问并等待 --在Telegram中提问，并在Claude Code中获得答案
- 内联按钮 --提供选项供用户选择
- 发送文件 --共享屏幕截图、日志、文档
- 实时监控 --注意收到的Telegram消息
- 多会话 --每个Claude Code会话都有自己的Telegram线程
建筑
Telegram group (is_forum: true, with Topics)
└── Thread per session ("{project} #{pid} — {time}")
│
daemon.py (single process, launchd, port 8765)
aiohttp HTTP API + single Telegram long-polling via httpx
│
proxy.py (stdio MCP, spawned by Claude Code)
Thin FastMCP proxy: lazy registration on first tool call
│
Claude Code (any number of sessions)为什么是两个过程？ Telegram Bot API只允许一个 getUpdates 按令牌轮询。守护进程集中轮询，并通过HTTP将消息分发到会话。
快速开始
1.创建Telegram机器人和群组
- 通过以下方式创建机器人 @植物学家 --保存令牌
- 创建Telegram群组，启用 话题 （组设置→ 主题）
- 以管理员身份将机器人添加到组中（需要“管理主题”权限）
- 获取群聊ID（发送消息，然后检查
https://api.telegram.org/bot/getUpdates)
2.安装
pip install telegram-mcp-bridge或来源：
git clone https://github.com/OlegPrivet/telegram-mcp-bridge.git
cd telegram-mcp-bridge
pip install -e .3.配置
mkdir -p ~/.claude/channels/telegram-daemon
cat > ~/.claude/channels/telegram-daemon/.env **注意（Windows）：** 配置目录为 `%USERPROFILE%\.claude\channels\telegram-daemon\.env`。使用以下命令创建它：
>
> ```powershell
> mkdir "$env:USERPROFILE\.claude\channels\telegram-daemon" -Force
> @"
> TELEGRAM_BOT_TOKEN=your-bot-token
> TELEGRAM_CHAT_ID=-100your-group-id
> DAEMON_PORT=8765
> "@ | Set-Content "$env:USERPROFILE\.claude\channels\telegram-daemon\.env"
> ```
### 5.在克劳德代码中注册MCP
claude mcp add telegram -s user -- tg-mcp-proxy
或者，如果从源代码安装：
claude mcp add telegram -s user -- python3 -m telegram_mcp_bridge.proxy
## MCP工具
|工具|说明|
|------|-------------|
| `send_message(message)` |发送消息（即发即弃）|
| `send_file(file_path, caption?)` |向线程发送文件/屏幕截图|
| `send_and_wait(message)` |发送并等待回复（超时5分钟）|
| `send_and_wait_with_options(message, options)` |使用内联按钮发送|
| `monitor_chat()` |等待传入消息（超时30分钟）|
| `check_inbox()` |检查未读邮件（非阻塞）|
| `list_sessions()` |列出活动会话|
## 管理
### 守护进程
Health check
curl -s http://127.0.0.1:8765/api/health
Active sessions
curl -s http://127.0.0.1:8765/api/sessions | python3 -m json.tool
Restart (macOS launchd)
launchctl kickstart -k gui/$(id -u)/com.claude.tg-mcp-daemon
Stop (macOS launchd)
launchctl bootout gui/$(id -u)/com.claude.tg-mcp-daemon
Restart (Windows Task Scheduler)
schtasks /end /tn "TelegramMCPDaemon" & schtasks /run /tn "TelegramMCPDaemon"
Stop (Windows Task Scheduler)
schtasks /end /tn "TelegramMCPDaemon"
Delete scheduled task (Windows)
schtasks /delete /tn "TelegramMCPDaemon" /f
Logs
tail -f ~/.claude/channels/telegram-daemon/daemon.log
### 代理
代理进程由Claude Code自动生成，每个会话一个。他们在退出时优雅地注销。
Proxy logs
tail -f /tmp/tg_mcp_proxy.log
## 配置
|变量|默认值|描述|
|----------|---------|-------------|
| `TELEGRAM_BOT_TOKEN` |--|来自@BotFather的机器人令牌（必填）|
| `TELEGRAM_CHAT_ID` |--|带主题的群聊ID（必填）|
| `DAEMON_PORT` | `8765` |后台程序的HTTP API端口|
| `SESSION_NAME` |auto |线程的自定义会话名称|
## 许可证
麻省理工学院