JinDaGe - mcp-crontab-server MCP Details

article

README

🚀 MCP 批任务查看器

MCP 批任务查看器是一款基于终端的用户界面工具，它采用模型上下文协议（MCP），可用于探索和监控 crontab 任务。无需离开终端环境，用户就能通过其直观的界面检查计划任务、查看任务状态以及最近日志。该工具采用客户端 - 服务器架构，将系统访问与展示逻辑分离，使代码组织更简洁、更易于维护。

✨ 主要特性

丰富的终端 UI：提供漂亮的表格和格式化输出。
日志查看：可查看最近的 cron 任务执行日志。
搜索功能：能够查找包含特定术语的 crontab 进程。

📦 安装指南

先决条件

Python 3.7+
pip（Python 包管理器）

安装依赖

pip install rich requests fastmcp

运行服务器

python mcp_crontab_server.py

运行客户端

python mcp_crontab_client_http.py

客户端启动后，将显示以下菜单选项：

列出 crontab 进程：显示所有 cron 任务。
查看最近日志：查看最新的 cron 任务执行日志。
搜索 crontab 进程：查找包含特定术语的进程。
退出：关闭查看器。

示例输出

        ╭────────────────────────────────────╮
        │ MCP 批任务查看器（HTTP 客户端） │
        ╰────────────────────────────────────╯
        使用模型控制协议 (MCP) 监控批任务的工具。

        正在连接到 MCP 服务器 http://127.0.0.1:8000
        检查服务器是否运行...
        成功连接！

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

        输入命令或退出（q）：

🔧 技术细节

MCP 批任务查看器由两部分组成：

服务器（mcp_crontab_server.py）：一个自定义 HTTP 服务器，实现模型上下文协议。通过 FastMCP 库注册工具，并通过 HTTP 端点进行暴露。
客户端（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

mcp-crontab-server