今天给大家介绍一个轻量中间层 —— 永动机(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 个小目标:能跑通、能复现、能独立改造。
- 学习过程中记录环境、账号、插件、模型、提示词和报错,方便后续复盘。
- 完成后用一个小项目验证,而不是只停留在看完课程或收藏资料。
常见问题
什么是“永动机”模式?
“永动机”模式指的是通过配置,使您的 Telegram 账号成为远程指令中枢。您可以在任何有网络的地方,向绑定了 Cursor 的 Telegram Bot 发送自然语言需求,它会自动驱动您本地的 Cursor Agent 执行编写、重构或调试代码等任务,从而实现近乎不间断的远程异步开发。
这个方案安全吗?我的代码会不会泄露?
安全性取决于您的配置。整个流程的核心是运行在您自己本地或自有服务器上的连接程序,代码始终在您可控的环境中被 Cursor 处理。Telegram 仅作为加密的指令传输通道,不接触您的代码本身。只要妥善保管好您的 Bot Token 和会话信息,风险是可控的。
相关阅读和学习路线
如果你想继续沿着“Cursor AI 编程”这个方向学习,可以先从下面这些站内内容建立路线,再回到本文判断具体资源是否适合自己。



评论(0)