Cron Schedule Audit

cron-schedule-audit-mcp

実際の IANA タイムゾーンデータベースを使用して cron 式を検証し、DST を正しく考慮した次回実行時刻を計算する MCP サーバーです。moment-timezone や luxon への依存はなく、プラットフォーム独自の tz データに対して、手書きの偽 UTC オフセット手法を使用します。

検出できるバグ

America/New_York で毎日午前 2:30 に実行するよう設定された cron ジョブ（30 2 * * *）は、春に時計が進む日に気付かないうちに一度も実行されません。その日は午前 2:00〜2:59 が存在しないためです。午前 1:30 に実行するジョブ（30 1 * * *）は、秋に時計が戻る日に2 回実行されます。その時間帯が繰り返されるためです。どちらの問題もエラーは発生せず、ログにも残りません。「時々実行されない」不安定な cron のように見えるだけです。テストでは、2026 年と 2027 年の実際の時刻変更日（2027-03-14 の春の時刻変更、2026-11-01 の秋の時刻変更）を使って検証しています。

また、ほとんどの人が一度は遭遇する、月の日と曜日に関する落とし穴にも警告します。POSIX cron では、両方のフィールドが制限されている場合、両者は AND ではなくORとして扱われます。

ツール

validate_cron_expression

構文と意味を検証します。OR と AND の取り違えに関する警告、毎分実行という落とし穴、一部の月に存在しない月の日の値（31、30、29）、午前 1〜3 時の範囲にあるスケジュールで DST リスクを確認するよう促す注意を提示します。式の意味を平易な言葉で説明します。

get_next_fire_times

DST を考慮して、次の N 回の実行時刻を返します。スケジュールされた現地時刻が春の時刻変更による欠落時間帯にあたる場合はスキップとして示され、秋の時刻変更による重複時間帯にあたる場合は、実際の 2 回の実行時刻を曖昧な時刻として両方返します。

detect_dst_risk

1 年先まで調べ、スケジュールが DST の時刻変更と重なるすべての日付を報告します。公開前に、現地時間の午前 1〜4 時に実行するよう設定されたジョブで一度実行してください。

使用方法

ホスト型（推奨）： MCPize — 無料プラン、Pro は月額 7 ドルです。

セルフホスト：

npm install
node server.js

小規模なツール群の一部

mcp-schema-audit-mcp、 regex-safety-audit-mcp、 claude-cost-audit-mcp。

ライセンス

MIT