Telegram MCP Server
应用介绍
Telegram MCP Server
通过 Telegram 远程控制 AI 编程助手（Claude Code / Codex）
PyPI Python License
English | 简体中文
为什么需要这个项目？
你是否遇到过这些场景：
💤 深夜躺在床上，突然想到一个需要修复的 bug，但不想起床打开电脑？
🚇 通勤路上，想让 AI 助手帮你重构代码，但笔记本电脑不在身边？
🏢 远程服务器上运行着多个 Claude Code 或 Codex 会话，想随时查看进度？
⏰ 长时间任务（测试、构建、重构）需要几小时，但你不想一直守在电脑前？
Telegram MCP Server 就是为了解决这些问题而生！
通过 MCP（Model Context Protocol）协议，这个项目让你可以：
📱 随时随地通过 Telegram 查看和控制 AI 编程助手
🔄 多会话管理：在远程服务器上用 screen 多开会话，同时管理多个项目
🌙 真正的无人值守：最长等待 7 天，智能轮询，不占用系统资源
💬 简单交互：通过 Telegram 发送消息，给 AI 助手下一步指示
特别适合：
24/7 运转的远程服务器
需要长时间执行的任务
多项目并行开发
随时随地的远程工作
特性
🌙 真正的无人值守 - 最长等待 7 天，智能渐进式轮询
📱 远程控制 - 通过 Telegram 随时随地控制 AI 助手
🔄 双向通信 - 发送通知，接收回复，持续对话
📁 文件操作 - 查看、下载项目文件
🎯 多会话管理 - 同时管理多个项目
🤖 通用支持 - 同时支持 Claude Code 和 Codex
快速开始
1. 安装
# 推荐：使用 uv
uv tool install telegram-mcp-server
# 或使用 pip
pip install telegram-mcp-server
2. 配置
方式 A：自动配置（推荐）
telegram-mcp-server --setup
交互式向导会帮你：
创建 Telegram Bot
获取凭据
自动配置 AI 助手
方式 B：使用 mcp add 命令手动添加
如果你已经有 Telegram Bot Token 和 Chat ID，可以使用 mcp add 命令快速添加：
Claude Code:
claude mcp add \
--transport stdio \
telegram \
--env TELEGRAM_BOT_TOKEN=你的TOKEN \
--env TELEGRAM_CHAT_ID=你的CHAT_ID \
-- \
uvx telegram-mcp-server
Codex:
codex mcp add telegram \
--env TELEGRAM_BOT_TOKEN=你的TOKEN \
--env TELEGRAM_CHAT_ID=你的CHAT_ID \
-- \
npx -y telegram-mcp-server
Gemini CLI:
gemini mcp add telegram uvx telegram-mcp-server \
-e TELEGRAM_BOT_TOKEN=你的TOKEN \
-e TELEGRAM_CHAT_ID=你的CHAT_ID
提示：将 你的TOKEN 和 你的CHAT_ID 替换为你的实际值
3. 使用
# 推荐：使用免确认完整授权模式启动
# 避免因权限确认导致 AI 助手与 Telegram 双向互动被意外打断
# 注意：因安全机制无法在 root 身份下启动
# Claude Code
claude --permission-mode bypassPermissions
# Codex
codex --dangerously-bypass-approvals-and-sandbox
# 在 AI 助手中
> 进入无人值守模式。任务：分析项目结构
在 Telegram 查看结果并继续对话！
工作原理
AI 助手 (Claude Code/Codex)
↓ MCP 协议
MCP 服务器 (telegram-mcp-server)
├─ 8 个工具（通知、等待、文件等）
└─ Telegram Bot（后台运行）
↓ Telegram API
你的 Telegram 客户端
核心功能
MCP 工具（8 个）
telegram_notify - 发送结构化通知（推荐使用）
telegram_wait_reply - 等待用户回复（阻塞式轮询）
telegram_unattended_mode - 无人值守模式（智能循环）
telegram_send_code - 发送代码（带语法高亮）
telegram_send_image - 发送图片
telegram_send_file - 发送文件
telegram_send - 发送自由格式消息
telegram_get_context_info - 获取会话上下文信息
Telegram 命令（6 个）
/sessions - 列出所有会话
/status <id> - 查看会话状态
/to <id> <msg> - 发送消息到会话
/file <id> <path> - 查看文件
/delete <id> - 删除会话
/help - 显示帮助
智能轮询
渐进式轮询策略，最长等待 7 天：
等待时长 检查频率 响应延迟
0-30 分钟 每 30 秒 最多 30 秒
30-60 分钟 每 60 秒 最多 60 秒
1 小时以上 每 120 秒 最多 120 秒
https://github.com/batianVolyc/telegram-mcp-server/tree/main
©软件著作权归作者所有。本站所有软件均来源于网络，仅供学习使用，请支持正版！
转载请注明出处： telegrambot » Telegram MCP Server
发表评论 取消回复