cron-mcp

cron-mcp

一个 MCP（Model Context Protocol） 服务，让 AI 编码 Agent — Claude、Cursor、Copilot、Cline — 能够解析、验证、解释和预览 cron 表达式。

旨在提前发现隐蔽的 cron 错误（不可能的计划、OR 语义陷阱、午夜峰值），在任务部署之前加以排查。这类错误很容易犯，也很难察觉，直到关键任务悄无声息地未能触发。

原因

Cron 表达式看似简单，实则容易出错。常见的隐蔽故障：

• 0 0 30 2 * → 永不运行（2 月没有 30 日）。语法有效，语义上却不起作用。
• 0 0 1,15 * 1 → 在每月 1 日或 15 日或星期一触发，而不是“如果是星期一，则在 1 日和 15 日触发”（经典的 dom+dow OR 语义陷阱）。
• */7 * * * * → 步长不均匀；间隔会漂移（:00, :07, :14, …, :56, :00 — 并非严格的“每 7 分钟”）。
• 0 0 * * * → 午夜峰值；系统中的所有任务都在 00:00 争抢资源。

cron-mcp 会将这些问题作为警告、观察结果和建议呈现出来，供 AI Agent 采取行动 — 在你发布计划之前。

提供的工具

工具	描述
parse_cron	解析 cron 表达式 → 用通俗语言说明触发时间。支持 5 字段标准 cron，以及 L（最后一天）、W（最近的工作日）、#（第 N 个星期几）和命名月份／星期几。
validate_cron	深度验证：不可能的计划、OR 语义、午夜峰值、步长不均匀、闰年边界情况、频率估算（每年运行次数）。
next_runs	计算接下来 N 次触发时间，以 ISO-8601 格式和相对偏移量表示。
cron_presets	常用且经过验证的计划库（每 5 分钟、每小时、工作日早上 9 点、每月、每季度等）。

安装

npm install -g cron-mcp-server

已发布链接

• npm 软件包 — 可安装版本 0.1.2
• Official MCP Registry — 注册记录
• GitHub 发布版本 — 可下载的源代码快照

配置

Claude Desktop

将配置添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS），或添加到操作系统中对应的文件：

{
  "mcpServers": {
    "cron": {
      "command": "cron-mcp-server",
      "args": []
    }
  }
}

Cursor

将配置添加到 .cursor/mcp.json（全局配置则添加到 ~/.cursor/mcp.json）：

{
  "mcpServers": {
    "cron": {
      "command": "cron-mcp-server"
    }
  }
}

VS Code（Copilot）

{
  "mcp.servers": {
    "cron": {
      "type": "stdio",
      "command": "cron-mcp-server"
    }
  }
}

直接运行（无需安装）

npx cron-mcp-server

使用示例

连接后，只需用自然语言向 Agent 提问：

• “验证这个 cron：0 0 30 2 *”
• “*/5 * * * * 下次什么时候触发？”
• “给我一个工作日每天早上 9 点运行的 cron”
• “0 0 1,15 * 1 有什么风险吗？”

Agent 会调用这些工具并返回结构化、可执行的结果。

引擎

Cron 引擎经过实战检验：638 行代码、零依赖，最初从一个基于浏览器的 cron 生成器中提取，并通过 69 个单元测试加固。这个 MCP 服务只是围绕该引擎的轻量工具封装。

许可证

MIT © takeaseatventure