MCP Cron

🚀 MCP 定时任务控制器

mcp-cron は Model Context Protocol (MCP) に基づくタイマータスクコントローラーです。これにより、ユーザーは cron 式を使用して定期タスクを定義および管理でき、shell コマンドと AI タスクをサポートします。

🚀 クイックスタート

mcp-cron は、MCP をベースにしたタイマータスクコントローラーで、cron 式を使ってタスクを管理できます。以下の手順で始めることができます。

✨ 主な機能

• タスク管理：タスクの追加、削除、更新、および照会をサポートします。
• タスクタイプ：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": "5分ごとに実行されるタスクのサンプル",
  "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 への関心とサポートに感謝します！