MCP Cron

🚀 MCP Scheduled Task Controller

mcp-cron is a scheduled task controller based on Model Context Protocol (MCP). It allows users to define and manage periodic tasks through cron expressions, supporting shell commands and AI tasks.

🚀 Quick Start

mcp-cron is a practical tool designed to simplify the management of scheduled tasks. It offers a user - friendly way to handle both shell commands and AI - related tasks, providing a seamless experience for task scheduling.

✨ Features

• Task Management: Supports adding, deleting, updating, and querying tasks.
• Task Types: Includes shell command tasks and AI tasks.
• Scheduled Scheduling: Uses cron expressions for task scheduling, supporting second - level precision.
• Status Tracking: Each task has detailed status information, including running status, last run time, next run time, etc.

📦 Installation

Installation Steps

# Clone the repository
git clone https://github.com/yourusername/mcp-cron.git
cd mcp-cron

# Install dependencies
go mod tidy

Running the Application

# Start the MCP server (listening on port 8080 by default)
go run cmd/mcp-cron/main.go

📚 Documentation

MCP Server

The MCP server is responsible for handling interactions with the model and provides the following interfaces:

• POST /api/v1/interact: Send user input to the model and get the model's response.
• GET /api/v1/ping: Check if the server is running normally.

Request Format

{
  "messages": [
    {
      "role": "user",
      "content": "Your query or instruction"
    }
  ],
  "model_id": "gpt-3.5-turbo",
  "temperature": 0.7,
  "max_tokens": 1000
}

Response Format

{
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "The model's response"
      },
      "finish_reason": "stop",
      "index": 0
    }
  ],
  "created": 1678945200,
  "id": "chatcmpl-abcde123",
  "model": "gpt-3.5-turbo"
}

Scheduled Task Controller

The scheduled task controller is responsible for managing user - defined tasks and provides the following interfaces:

• GET /tasks: Get all tasks.
• GET /tasks/:id: Get specific task information.
• POST /tasks: Add a new task.
• PUT /tasks/:id: Update an existing task.
• DELETE /tasks/:id: Delete a task.

Task Format

{
  "id": "task_1234567890",
  "name": "Example Task",
  "schedule": "0 */5 * * * *",
  "command": "echo 'Task is being executed...'",
  "prompt": "Analyze yesterday's sales data and provide a summary",
  "type": "shell_command", // or AI
  "description": "An example task that runs every five minutes",
  "enabled": true,
  "lastRun": "2025-01-01T12:00:00Z",
  "nextRun": "2025-01-01T12:05:00Z",
  "status": "completed",
  "createdAt": "2025-01-01T00:00:00Z",
  "updatedAt": "2025-01-01T12:00:00Z"
}

Status Values

The task status can be one of the following:

• pending: Not yet run.
• running: Currently running.
• completed: Completed.
• failed: Execution failed.
• disabled: Disabled.

🔧 Technical Details

Project Structure

mcp-cron/
├── cmd/          # Application entry point
│   └── mcp-cron/
├── internal/    # Core function packages
│   ├── agent/    # AI agent execution logic
│   ├── command/  # Shell command execution logic
│   ├── config/   # Configuration processing
│   ├── errors/   # Error handling
│   ├── logging/  # Logging tools
│   ├── model/    # Data models and types
│   ├── scheduler/ # Task scheduler
│   └── server/   # MCP server implementation
└── scripts/     # Tool scripts

Development and Testing

Starting the Development Environment

# Start the MCP server and scheduled task controller
go run cmd/mcp-cron/main.go

Testing Interfaces

Use curl or Postman to test the API:

• Get all tasks

curl http://localhost:8080/tasks

• Add a new task

curl -X POST -H "Content-Type: application/json" -d '{"name":"My First Task","schedule":"0 */1 * * * *","command":"echo \"Test succeeded!\""}' http://localhost:8080/tasks

Dependency Management

The project uses Go modules for dependency management:

module mcp-cron

go 1.20

require (
	github.com/gin-gonic/gin v1.9.1
	github.com/segmentio/go-uuid v1.4.3
)

📄 License

This project follows the MIT license. For details, see the LICENSE file.

Contributors

• Author: [Your Name]
• Maintainer: [Your Name]

Thank you for your attention and support for mcp-cron!