今天给大家介绍一个轻量中间层 —— 永动机(telegram-agent-bot),让你用手机通过 Telegram Bot 远程控制 Cursor AI Agent 执行编程任务。出门在外发一条消息,家里的 Cursor 就能自动写代码、改文件,需要放权时在手机点按钮即可。
项目概述
永动机是一个开源中间层,连接 Telegram Bot 与 Cursor 的 MCP(Model Context Protocol)。你通过 Bot 发任务,任务写入本地队列,Cursor Agent 通过 MCP 的 wait_for_task 获取并执行。需要审批时,Agent 调用 request_approval,Bot 推送「允许/拒绝」按钮到你手机,点选后 Agent 继续执行。
核心特性
- 手机发任务 – 直接给 Bot 发消息,任务加入队列
- Cursor Agent 执行 – 通过 MCP 获取任务,用 Cursor 自带模型,不花额外钱
- 远程放权 – 需要审批时 Bot 推送按钮,手机点选
- 统一流程 – 三种情景(有项目在跑、人在外面、出门前说一声)全覆盖
- 守护脚本 – daemon 每 10 秒轮询,Agent 忙则任务排队,不卡
架构
手机 → Telegram Bot → 写入任务队列
↓
MCP: wait_for_task() ← 阻塞等待
↓
Cursor Agent 执行
↓
需要放权 → request_approval() → 手机点按钮
完成 → report_done() → 推送到手机
↓
继续 wait_for_task 或 daemon 唤起下一个
三种情景
- 有项目在跑,人走开 – Agent 忙 → 新任务排队 → 干完自动取下一个
- 没项目跑,人在外面 – daemon 检测到任务 → 唤起 Agent(Cursor 未开则启动)
- 出门前说「我要出门了」 – Agent 进入 wait_for_task → 直接消费任务
快速开始
git clone https://github.com/xuese2021/telegram-agent-bot.git
cd telegram-agent-bot
cp .env.example .env
# 填入 TELEGRAM_BOT_TOKEN、ALLOWED_USER_IDS
pip install -r requirements.txt
python main.py
配置 Cursor MCP 指向 mcp_middleware_server.py,可选运行 python daemon.py 作为守护。
MCP 工具
- wait_for_task – 阻塞等待新任务
- request_approval – 请求放权,等用户手机点按钮
- report_done – 汇报完成,推送到手机
- report_progress – 汇报进度
技术栈
Python 3.10+、python-telegram-bot、fastmcp、pyautogui/pyperclip/pygetwindow
Cursor AI 编程内容重点
这篇内容围绕《永动机:用 Telegram 远程控制 Cur or Agent 写代码》做进一步整理,重点不是简单收藏资源名,而是帮助你判断它和当前任务是否匹配。建议先看清楚学习目标、使用场景和目录结构,再决定是否继续投入时间。
适合谁先看
- 正在查找Cursor AI 编程、相关课程或实操案例,想快速判断内容价值的人。
- 已经接触过AI、cursor、telegarm、大模型,但还缺少系统路线和落地步骤的人。
- 希望把教程内容转成真实项目、自动化流程、作品交付或效率提升的人。
学习前先确认什么
- 先确认核心目标:安装配置、读懂项目、修改代码、运行验证和交付复盘。
- 再确认自己的基础:适合把 AI 编程工具真正放进项目流程,而不是只停留在提问和复制代码。
- 最后确认风险点:重点关注需求拆解、上下文管理、版本控制、测试和回滚。
推荐使用方式
- 先通读介绍,提取目录、工具、平台、交付物和适合人群。
- 把课程或资源拆成 3 个小目标:能跑通、能复现、能独立改造。
- 学习过程中记录环境、账号、插件、模型、提示词和报错,方便后续复盘。
- 完成后用一个小项目验证,而不是只停留在看完课程或收藏资料。
常见问题
这类Cursor AI 编程内容适合零基础吗?
如果你是零基础,建议先从安装、账号、基础概念和最小可用案例开始,不要一开始就追求复杂工作流。能独立复现一个小结果,比一次性看完大量章节更重要。
怎么判断它是否值得长期学习?
看三个信号:内容是否有清晰目录,是否覆盖实际操作,是否能解决明确问题。如果只有概念介绍或资源堆叠,就更适合当作补充材料,而不是主线教程。
相关阅读和学习路线
如果你想继续沿着“Cursor AI 编程”这个方向学习,可以先从下面这些站内内容建立路线,再回到本文判断具体资源是否适合自己。



评论(0)