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