Cron Tools

cron-tools MCP 服务

解析、解释、验证并安排 Vixie cron 方言中的 5 字段 cron 表达式（Linux crontab、GitHub Actions 和大多数调度器），支持列表、范围、步长、月份和星期名称、用 0 或 7 表示星期日，以及 @hourly 到 @yearly 宏。时区运算仅使用 Intl；除 MCP SDK 和 zod 外没有其他依赖。

属于 dev-mcp-servers 项目。仅支持 Stdio 传输；服务不会打开端口。

工具

工具	输入	返回内容
parse_cron	expression	各字段的原始文本、通配符标记和所有可接受的值；以及规范化后的表达式和宏展开结果。
explain_cron	expression	一句英文说明，例如 */15 9-17 * * 1-5 表示“每周一至周五的 9 点到 17 点之间，每小时的第 15 分钟运行一次。”
validate_cron	expression	valid、错误和警告：两个日期字段均受限（OR 语义）、在所选月份中不会出现的日期、表示星期日的 7、? 写法以及宏展开结果。
next_runs	expression、count?（1 至 100）、timezone?（IANA）、from?（ISO 8601）	即将运行的时间，包含本地时间及偏移量和 UTC 时间。夏令时向前切换时跳过的墙上时间当天不会运行；重复的小时会运行两次。搜索范围最长为十年。
previous_runs	与 next_runs 相同的输入	严格早于 from 的运行时间，按从近到远排列，包含本地时间及偏移量和 UTC 时间。使用相同的夏令时语义和十年搜索范围。

安装

Claude Code：

claude mcp add cron-tools -- docker run --rm -i ghcr.io/basitalisandhu/mcp-cron-tools:0.2.2

添加 -s user，即可在每个项目中使用。任何读取 .mcp.json 的客户端（Claude Code、Claude Desktop、Cursor）：

{
  "mcpServers": {
    "cron-tools": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/basitalisandhu/mcp-cron-tools:0.2.2"]
    }
  }
}

请按示例固定版本，避免更新在你未察觉的情况下改变编辑器中运行的内容。该软件包尚未发布到 npmjs.com，因此 npx 无法使用；GitHub Packages npm 的使用方法请参阅仓库 README。从检出目录构建时，请先在仓库根目录运行 npm install && npm run build，然后使用 "command": "node", "args": ["<path>/packages/cron-tools/dist/index.js"]。

涉及内容

• 网络：无。
• 本地文件：无。
• 遥测：无。

说明

• 不支持秒字段（6 字段的 Quartz 表达式）和 L、W、#，并会给出说明。
• 当“月中的日期”和“星期”都受限时，与 Vixie cron 一样，任一字段匹配即表示该日期匹配。

构建与测试

npm install        # at the repository root
npm run build -w @basitalisandhu/mcp-cron-tools
npm test -w @basitalisandhu/mcp-cron-tools

测试使用 node:test 和 SDK 的内存传输，不会访问网络。

许可

MIT。请参阅 LICENSE。