MCP Crontab Server

🚀 MCP 批任務查看器

MCP 批任務查看器是一款基於終端的用戶界面工具，藉助模型上下文協議（MCP）實現。它能讓你在不離開終端環境的情況下，探索和監控 crontab 任務。通過直觀界面，可輕鬆檢查計劃任務、查看狀態以及最近日誌。客戶端 - 服務器架構的設計，將系統訪問與展示邏輯分離，保證了代碼組織的簡潔性和可維護性。

🚀 快速開始

MCP 批任務查看器使用簡單，按以下步驟操作即可開啟任務監控之旅：

1. 確保滿足安裝的先決條件。
2. 安裝所需依賴。
3. 分別啟動服務器和客戶端。
4. 在客戶端啟動後，根據菜單選項進行操作。

示例輸出

╭────────────────────────────────────╮
│ MCP 批任務查看器（HTTP 客戶端） │
╰────────────────────────────────────╯
使用模型控制協議 (MCP) 監控批任務的工具。

正在連接到 MCP 服務器 http://127.0.0.1:8000
檢查服務器是否運行...
成功連接！

可用工具：
╭──────┬─────────────────╮
│ 命令   │ 描述           │
├──────┼─────────────────┤
│ list  │ 列出所有 cron 進程|
│ log   │ 查看最近日誌     |
│ search│ 搜索特定術語      │
╰──────┴─────────────────╯

輸入命令或退出（q）：

✨ 主要特性

• 豐富的終端 UI：擁有漂亮的表格和格式化輸出，提供良好的視覺體驗。
• 日誌查看：可方便地查看最近的 cron 任務執行日誌。
• 搜索功能：能查找包含特定術語的 crontab 進程。

📦 安裝指南

先決條件

• Python 3.7+
• pip（Python 包管理器）

安裝依賴

pip install rich requests fastmcp

運行服務器

python mcp_crontab_server.py

運行客戶端

python mcp_crontab_client_http.py

客戶端啟動後，將顯示以下菜單選項：

1. 列出 crontab 進程：顯示所有 cron 任務。
2. 查看最近日誌：查看最新的 cron 任務執行日誌。
3. 搜索 crontab 進程：查找包含特定術語的進程。
4. 退出：關閉查看器。

🔧 技術細節

架構

MCP 批任務查看器由兩部分組成：

1. 服務器（mcp_crontab_server.py）：這是一個自定義 HTTP 服務器，實現了模型上下文協議。通過 FastMCP 庫註冊工具，並通過 HTTP 端點進行暴露。
2. 客戶端（mcp_crontab_client_http.py）：具備豐富的終端 UI，通過 HTTP 請求與服務器通信，並使用 Rich 庫進行格式化展示。

此架構展示了以下特點：

• 服務端 MCP 實現及工具註冊，保證了系統的規範性和可擴展性。
• 基於 HTTP 的組件間通信，實現了高效的數據交互。
• 系統訪問（服務端）和展示邏輯（客戶端）的乾淨分離，提高了代碼的可維護性和可測試性。

MCP 符合性

• 使用 FastMCP 庫實現工具註冊，確保工具的統一管理。
• 支持 /tools 端點返回可用工具列表，方便用戶瞭解系統功能。
• 通過 HTTP POST 請求調用工具，格式為 /tools/{tool_name}，提供了標準化的工具調用方式。
• 返回一致的 JSON 格式結果，便於數據的解析和處理。客戶端採用標準 HTTP 請求而非 MCP 特定庫，使其兼容任何 HTTP 客戶端，同時在服務端保持核心 MCP 模式的實現。

要求

• fastmcp
• rich
• requests