今天给大家介绍一个轻量中间层 —— 永动机（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

 

资源下载
GitHub
提示：如链接失效，请在评论区留言