mcp-cron 0.2.2 → 0.4.0

package/README.md

@@ -9,6 +9,7 @@ Model Context Protocol (MCP) server for scheduling and managing tasks through a
 - [Manage tasks](#available-mcp-tools) via MCP protocol
 - Task execution with command output capture
 - Task persistence across restarts (SQLite)
+- Multi-instance safe — multiple instances can share the same database without duplicate execution
 
 ## Installation
 
@@ -173,6 +174,7 @@ The following command line arguments are supported:
 | `--mcp-config-path` | Path to MCP configuration file | `~/.cursor/mcp.json` |
 | `--db-path` | Path to SQLite database for result history | `~/.mcp-cron/results.db` |
 | `--prevent-sleep` | Prevent system from sleeping while mcp-cron is running (macOS and Windows) | `false` |
+| `--poll-interval` | How often to check for due tasks | `1s` |
 
 ### Environment Variables
 
@@ -199,6 +201,7 @@ The following environment variables are supported:
 | `MCP_CRON_MCP_CONFIG_FILE_PATH` | Path to MCP configuration file | `~/.cursor/mcp.json` |
 | `MCP_CRON_STORE_DB_PATH` | Path to SQLite database for result history | `~/.mcp-cron/results.db` |
 | `MCP_CRON_PREVENT_SLEEP` | Prevent system from sleeping while mcp-cron is running (macOS and Windows) | `false` |
+| `MCP_CRON_POLL_INTERVAL` | How often to check for due tasks (Go duration format) | `1s` |
 
 ### Sleep Prevention
 
@@ -234,15 +237,16 @@ When running with stdio transport, logs are redirected to a `mcp-cron.log` log f
 
 The server exposes several tools through the MCP protocol:
 
-1. `list_tasks` - Lists all scheduled tasks
+1. `list_tasks` - Lists all tasks (scheduled and on-demand)
 2. `get_task` - Gets a specific task by ID
-3. `add_task` - Adds a new scheduled task
-4. `add_ai_task` - Adds a new scheduled AI (LLM) task with a prompt
+3. `add_task` - Adds a new shell command task (provide `schedule` for recurring, or omit for on-demand)
+4. `add_ai_task` - Adds a new AI (LLM) task with a prompt (provide `schedule` for recurring, or omit for on-demand)
 5. `update_task` - Updates an existing task
 6. `remove_task` - Removes a task by ID
-7. `enable_task` - Enables a disabled task
-8. `disable_task` - Disables an enabled task
-9. `get_task_result` - Gets execution results for a task (latest by default, or recent history with `limit`)
+7. `run_task` - Immediately executes a task by ID (for on-demand tasks or ad-hoc runs of scheduled tasks)
+8. `enable_task` - Enables a task so it runs on its schedule or can be triggered via `run_task`
+9. `disable_task` - Disables a task so it stops running and cannot be triggered
+10. `get_task_result` - Gets execution results for a task (latest by default, or recent history with `limit`)
 
 ### Task Format
 
@@ -270,6 +274,12 @@ For shell command tasks, use the `command` field to specify the command to execu
 For AI tasks, use the `prompt` field to specify what the AI should do.
 The `type` field can be either `shell_command` (default) or `AI`.
 
+**Scheduled vs on-demand tasks:**
+- **Scheduled**: Provide a `schedule` (cron expression) — the task runs automatically on that schedule.
+- **On-demand**: Omit `schedule` — the task sits idle until triggered via `run_task`.
+
+`run_task` also works on scheduled tasks for ad-hoc execution outside their normal schedule. After execution, scheduled tasks resume their normal schedule; on-demand tasks return to idle.
+
 ### Task Status
 
 The tasks can have the following status values:
@@ -281,7 +291,7 @@ The tasks can have the following status values:
 
 ### Cron Expression Format
 
-The scheduler uses the [github.com/robfig/cron/v3](https://github.com/robfig/cron) library for parsing cron expressions. The format includes seconds:
+Cron expressions are required for scheduled tasks and omitted for on-demand tasks. The scheduler uses the [github.com/robfig/cron/v3](https://github.com/robfig/cron) library for parsing. The format includes seconds:
 
 ```
 ┌───────────── second (0 - 59) (Optional)
@@ -341,4 +351,4 @@ See [docs/testing.md](docs/testing.md) for the full testing guide, including int
 ## Acknowledgments
 
 - [modelcontextprotocol/go-sdk](https://github.com/modelcontextprotocol/go-sdk) - Official Go SDK for the Model Context Protocol
-- [robfig/cron](https://github.com/robfig/cron) - Cron library for Go 
+- [robfig/cron](https://github.com/robfig/cron) - Cron expression parsing for Go

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-cron",
-  "version": "0.2.2",
+  "version": "0.4.0",
   "description": "MCP server for cron task scheduling (shell commands and AI prompts)",
   "license": "AGPL-3.0-only",
   "bin": {
@@ -11,11 +11,11 @@
     "url": "git+https://github.com/jolks/mcp-cron.git"
   },
   "optionalDependencies": {
-    "mcp-cron-darwin-amd64": "0.2.2",
-    "mcp-cron-darwin-arm64": "0.2.2",
-    "mcp-cron-linux-amd64": "0.2.2",
-    "mcp-cron-linux-arm64": "0.2.2",
-    "mcp-cron-windows-amd64": "0.2.2",
-    "mcp-cron-windows-arm64": "0.2.2"
+    "mcp-cron-darwin-amd64": "0.4.0",
+    "mcp-cron-darwin-arm64": "0.4.0",
+    "mcp-cron-linux-amd64": "0.4.0",
+    "mcp-cron-linux-arm64": "0.4.0",
+    "mcp-cron-windows-amd64": "0.4.0",
+    "mcp-cron-windows-arm64": "0.4.0"
   }
 }