MCP Cron

🚀 MCP 定時任務控制器

mcp-cron 是一個基於 Model Context Protocol (MCP) 的定時任務控制器。它能讓用戶通過 cron 表達式定義和管理定期任務，支持 shell 命令和 AI 任務，為任務調度提供了便捷的解決方案。

🚀 快速開始

mcp-cron 是基於 Model Context Protocol (MCP) 的定時任務控制器，允許用戶通過 cron 表達式定義和管理定期任務，支持 shell 命令和 AI 任務。以下是快速上手的步驟：

安裝

# 克隆倉庫
git clone https://github.com/yourusername/mcp-cron.git
cd mcp-cron

# 安裝依賴
go mod tidy

運行

# 啟動 MCP 服務器（默認監聽 8080 端口）
go run cmd/mcp-cron/main.go

✨ 主要特性

• 任務管理：支持添加、刪除、更新和查詢任務，方便用戶靈活操作。
• 任務類型：包括 shell 命令任務和 AI 任務，滿足不同場景需求。
• 定時調度：使用 cron 表達式進行任務調度，支持秒級別精度，實現精準定時。
• 狀態跟蹤：每個任務都有詳細的狀態信息，包括運行狀態、上次運行時間和下次運行時間等，便於用戶即時掌握任務情況。

📦 安裝指南

安裝

# 克隆倉庫
git clone https://github.com/yourusername/mcp-cron.git
cd mcp-cron

# 安裝依賴
go mod tidy

運行

# 啟動 MCP 服務器（默認監聽 8080 端口）
go run cmd/mcp-cron/main.go

💻 使用示例

MCP 服務器

MCP 服務器負責處理與模型的交互，提供以下接口：

• POST /api/v1/interact：發送用戶輸入到模型，獲取模型響應。
• GET /api/v1/ping：檢查服務器是否正常運行。

請求格式

{
  "messages": [
    {
      "role": "user",
      "content": "你的查詢或指令"
    }
  ],
  "model_id": "gpt-3.5-turbo",
  "temperature": 0.7,
  "max_tokens": 1000
}

響應格式

{
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "模型的響應"
      },
      "finish_reason": "stop",
      "index": 0
    }
  ],
  "created": 1678945200,
  "id": "chatcmpl-abcde123",
  "model": "gpt-3.5-turbo"
}

定時任務控制器

定時任務控制器負責管理用戶定義的任務，提供以下接口：

• GET /tasks：獲取所有任務
• GET /tasks/:id：獲取特定任務信息
• POST /tasks：添加新任務
• PUT /tasks/:id：更新現有任務
• DELETE /tasks/:id：刪除任務

任務格式

{
  "id": "task_1234567890",
  "name": "示例任務",
  "schedule": "0 */5 * * * *",
  "command": "echo '任務執行中...'",
  "prompt": "分析昨天的銷售數據並提供摘要",
  "type": "shell_command", // 或者 AI
  "description": "一個每五分鐘運行一次的任務示例",
  "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"
}

狀態值

任務狀態可以是以下之一：

• pending：未運行
• running：正在運行
• completed：已完成
• failed：執行失敗
• disabled：已禁用

📚 詳細文檔

項目結構

mcp-cron/
├── cmd/          # 應用程序入口點
│   └── mcp-cron/
├── internal/    # 核心功能包
│   ├── agent/    # AI 代理執行邏輯
│   ├── command/  # shell 命令執行邏輯
│   ├── config/   # 配置處理
│   ├── errors/   # 錯誤處理
│   ├── logging/  # 日誌工具
│   ├── model/    # 數據模型和類型
│   ├── scheduler/ # 任務調度器
│   └── server/   # MCP 服務器實現
└── scripts/     # 工具腳本

開發與測試

啟動開發環境

# 啟動 MCP 服務器和定時任務控制器
go run cmd/mcp-cron/main.go

測試接口

使用 curl 或 Postman 進行 API 測試：

獲取所有任務

curl http://localhost:8080/tasks

添加新任務

curl -X POST -H "Content-Type: application/json" -d '{"name":"我的第一個任務","schedule":"0 */1 * * * *","command":"echo \"測試成功!\""}' http://localhost:8080/tasks

依賴管理

項目使用 Go 模塊進行依賴管理：

module mcp-cron

go 1.20

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

📄 許可證

本項目遵循 MIT 許可證，詳見 LICENSE 文件。

👥 貢獻者

• 作者：[你的名字]
• 維護者：[你的名字]

感謝您對 mcp-cron 的關注與支持！