cron-mcp

cron-mcp

AI コーディングエージェント（Claude、Cursor、Copilot、Cline）が cron 式を解析、検証、説明し、プレビューできる MCP（Model Context Protocol） サーバーです。

ジョブをデプロイする前に、気づきにくい cron の不具合（実行不可能なスケジュール、OR セマンティクスの落とし穴、午前 0 時の集中）を検出できるように設計されています。こうしたミスは起こりやすく、重大なジョブがひっそり実行されなくなるまで気づきにくいものです。

理由

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 * * * → 午前 0 時に集中します。システム内のすべてのジョブが 00:00 に競合します。

cron-mcp は、AI エージェントが対処できる警告、所見、提案としてこれらをスケジュールのリリース前に提示します。

提供するツール

ツール	説明
parse_cron	cron 式を解析し、実行タイミングを平易な英語で説明します。5 フィールドの標準 cron に加え、L（最終日）、W（最も近い平日）、#（第 n 曜日）、名前付きの月・曜日に対応しています。
validate_cron	詳細な検証を行います。実行不可能なスケジュール、OR セマンティクス、午前 0 時の集中、不均等なステップ、うるう年の境界条件、頻度の推定（年間の実行回数）を確認します。
next_runs	次に実行される N 回の日時を ISO-8601 形式と相対時間で計算します。
cron_presets	一般的で実績のあるスケジュール（5 分ごと、毎時、平日の午前 9 時、毎月、四半期ごとなど）をまとめたライブラリです。

インストール

npm install -g cron-mcp-server

公開リンク

• npm パッケージ — インストール可能なリリース 0.1.2
• 公式 MCP レジストリ — レジストリの記録
• GitHub リリース — ダウンロード可能なソースのスナップショット

設定

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）またはご利用の OS における同等のファイルに追加します。

{
  "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

使用例

接続したら、エージェントに自然な言葉で尋ねるだけです。

• 「この cron を検証してください：0 0 30 2 *」
• 「*/5 * * * * は次にいつ実行されますか？」
• 「平日の毎朝 9 時に実行する cron を作成してください」
• 「0 0 1,15 * 1 にリスクはありますか？」

エージェントがツールを呼び出し、構造化された、実行に移せる結果を返します。

エンジン

cron エンジンは実績のあるもので、638 行、依存関係ゼロです。もともとブラウザー上で動作する cron ジェネレーターから切り出され、69 件の単体テストで強化されました。この MCP サーバーは、そのエンジンを薄く包むツールラッパーです。

ライセンス

MIT © takeaseatventure