cron-mcp

cron-mcp

由 Shreyas 构建 · 由 Globalion 发布

Cron 即服务 MCP。使用任意 cron 表达式安排任意提示词；触发时，我们会将任务 POST 到你的回调 URL。我们的技术栈中不包含大模型。

你的 Agent（Claude Desktop、Cursor、自定义脚本）负责思考。我们只负责：

• 存储计划、提示词和你的回调 URL
• 根据 cron 表达式匹配分钟
• 将任务正文 POST 到你的回调，并使用 X-Cron-Signature 签名

就是这样。非常适合每日简报、每小时轮询、每周摘要，或任何按固定计划重复执行且需要通过大模型运行的任务。

可在 cron.regiq.in 使用，也可以通过下方的 Docker Compose 自托管。

使用（托管版）

1. 访问 https://cron.regiq.in，使用 Google 或 GitHub 登录。

2. 在控制面板中生成 MCP API 密钥并复制。

3. 将其添加到 Claude Desktop 的 claude_desktop_config.json（或 Cursor／任意 MCP 客户端）中：

   {
     "mcpServers": {
       "cron": {
         "url": "https://cron.regiq.in/api/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_KEY_HERE"
         }
       }
     }
   }
   

4. 让你的 Agent 调用 schedule_job，并提供 cron 表达式、提示词，以及触发时我们要 POST 到的 URL。

工具

工具	用途
schedule_job(name, cron, prompt, callbackUrl, ...)	创建定时提示词。
list_jobs()	返回调用密钥拥有的所有任务。
get_job(id)	返回一个任务及最近 20 次触发尝试。
update_job(id, ...)	部分更新。设置 isActive: false 可暂停任务。
delete_job(id)	永久删除。

Webhook 负载

任务触发时，我们会 POST：

POST <your callbackUrl>
Content-Type: application/json
X-Cron-Signature: <hex-hmac-sha256-of-body>

{
  "jobId":    "clx...",
  "name":     "daily AI news briefing",
  "prompt":   "summarise the top 5 AI news items from the last 24h",
  "metadata": { ... },
  "firedAt":  "2026-07-16T08:00:00.412Z"
}

验证签名：使用共享签名密钥（环境变量 CRON_WEBHOOK_SIGNING_SECRET）对原始正文重新计算哈希，并与 X-Cron-Signature 请求头进行比较。返回任意 2xx 状态码即可将本次触发标记为成功；其他状态都会记录为失败，但计划仍会继续推进（因此，失败的回调不会阻止后续运行）。

自托管

你需要：

• Docker + Compose
• Google OAuth 客户端 — Cloud Console。作用域：openid、email、profile。重定向地址：<PUBLIC_BASE_URL>/api/auth/callback/google
• 公共 HTTPS 域名（Cloudflare Tunnel，或在本地运行 ngrok http 3015）

无需大模型密钥。 推理在你的回调中进行。

git clone https://github.com/globalion/cron-mcp
cd cron-mcp
cp .env.example .env
# fill NEXTAUTH_SECRET, GOOGLE_*, PUBLIC_BASE_URL, CRON_WEBHOOK_SIGNING_SECRET
docker compose up -d
# open http://localhost:3015

架构

  Your agent                                Your callback
     │                                            ▲
     │ schedule_job(cron, prompt,                 │
     │              callback_url)                 │
     ▼                                            │
   ┌──────────────────────────────────────────────────┐
   │  cron-mcp (Hetzner)                              │
   │  - /api/mcp     Bearer-auth JSON-RPC             │
   │    · schedule_job, list, get, update, delete     │
   │  - Postgres: User, ApiKey, Job, JobRun           │
   │  - Scheduler loop (60s tick) — matches cron,     │
   │    POSTs signed webhook to callback_url,         │
   │    logs a JobRun row per fire.                   │
   └──────────────────────────────────────────────────┘
                             │
                             │  POST (signed)
                             ▼
                    Your callback runs the
                    prompt through the LLM +
                    tools and delivers the result.

许可证

MIT。参见 LICENSE。