English Français العربية

io.github.takeaseatventure/cron-mcp

السجل الرسمي الذكاء الاصطناعي والوكلاء

MCP cron validator for AI agents; flags impossible schedules and other silent cron bugs.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package cron-mcp-server
Claude Code 
claude mcp add cron-mcp -- npx -y cron-mcp-server@0.1.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "cron-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cron-mcp-server@0.1.2"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. cron-mcp
  2. Why
  3. Tools exposed
  4. Install
  5. Published links
  6. Configure
  7. Example usage
  8. Engine
  9. License

cron-mcp

An MCP (Model Context Protocol) server that lets AI coding agents — Claude, Cursor, Copilot, Cline — parse, validate, explain, and preview cron expressions.

Built to catch silent cron bugs (impossible schedules, OR-semantics gotchas, midnight spikes) before a job is deployed — a class of mistake that's easy to make and hard to notice until a critical job silently fails to fire.

Why

Cron expressions are deceptively tricky. Common silent failures:

  • 0 0 30 2 * → never runs (February has no 30th). Syntactically valid, semantically dead.
  • 0 0 1,15 * 1 → fires on the 1st OR 15th OR Monday, not "the 1st and 15th if Monday" (the classic dom+dow OR-semantics trap).
  • */7 * * * * → uneven step; intervals drift (:00, :07, :14, …, :56, :00 — not "every 7 minutes" cleanly).
  • 0 0 * * * → midnight spike; every job in the system competes at 00:00.

cron-mcp surfaces these as warnings, observations, and suggestions that the AI agent can act on — before you ship the schedule.

Tools exposed

ToolDescription
parse_cronParse a cron expression → plain-English description of when it fires. Supports 5-field standard cron + L (last), W (nearest weekday), # (nth weekday), named months/days.
validate_cronDeep validation: impossible schedules, OR-semantics, midnight spikes, uneven steps, leap-year edges, frequency estimate (~runs/year).
next_runsCompute the next N fire times as ISO-8601 + relative offsets.
cron_presetsLibrary of common, proven schedules (every 5 min, hourly, weekdays 9am, monthly, quarterly, …).

Install

npm install -g cron-mcp-server

Configure

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent on your OS:

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

Add to .cursor/mcp.json (or ~/.cursor/mcp.json for global):

{
  "mcpServers": {
    "cron": {
      "command": "cron-mcp-server"
    }
  }
}
VS Code (Copilot)
{
  "mcp.servers": {
    "cron": {
      "type": "stdio",
      "command": "cron-mcp-server"
    }
  }
}
Direct (no install)
npx cron-mcp-server

Example usage

Once connected, just ask the agent in natural language:

  • "Validate this cron: 0 0 30 2 *"
  • "When does */5 * * * * next fire?"
  • "Give me a cron for every weekday at 9am"
  • "Is there anything risky about 0 0 1,15 * 1?"

The agent calls the tools and returns structured, actionable results.

Engine

The cron engine is battle-tested: 638 lines, zero dependencies, originally extracted from a browser-based cron generator and hardened with 69 unit tests. This MCP server is a thin tool wrapper around it.

License

MIT © takeaseatventure

الأسئلة الشائعة

ما هو io.github.takeaseatventure/cron-mcp؟

MCP cron validator for AI agents; flags impossible schedules and other silent cron bugs.

كيف أثبّت io.github.takeaseatventure/cron-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add cron-mcp -- npx -y cron-mcp-server@0.1.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.takeaseatventure/cron-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.takeaseatventure/cron-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.takeaseatventure/cron-mcp؟

ينشره takeaseatventure. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.