MCP Crontab 浏览器

一个基于终端 UI 的工具，用于使用模型上下文协议 (MCP) 浏览和监控 crontab 条目。该工具提供了一个直观的界面，用于检查计划任务、检查其状态以及查看最近的日志，而无需离开终端环境。它采用客户端-服务器架构构建，将系统访问与表示问题分离，从而实现清晰的代码组织和可维护的组件。

特性

• 丰富的终端 UI: 美观的表格和格式化的输出
• 日志查看: 查看最近的 cron 作业执行日志
• 搜索功能: 查找包含特定术语的 crontab 条目

架构

MCP Crontab 浏览器由两个主要组件组成：

1. 服务器 (mcp_crontab_server.py): 一个自定义 HTTP 服务器，实现了模型上下文协议。它使用 FastMCP 库注册工具，并通过 HTTP 端点公开它们。

2. 客户端 (mcp_crontab_client_http.py): 一个丰富的终端 UI，它使用 HTTP 请求与服务器通信，并使用 Rich 库格式化显示结果。

此架构演示了：

• 使用工具注册的服务器端 MCP 实现
• 组件之间基于 HTTP 的通信
• 系统访问（服务器）和表示（客户端）之间清晰的关注点分离

安装

前提条件

• 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 Crontab Explorer (HTTP Client) │
        ╰────────────────────────────────────╯
        A tool for monitoring crontab entries using the Model Control Protocol (MCP).

        Connecting to MCP server at http://127.0.0.1:8000
        Checking if server is running...
        Socket connection successful
        Trying HTTP request with curl...
        Curl HTTP status: 200
        Server is running!
        Checking if server is running...
        Socket connection successful
        Trying HTTP request with curl...
        Curl HTTP status: 200
        Server is running!
        Requesting tools list...
        Tools response status: 200
        Successfully parsed tools: 3 found
        Connected to server. Found 3 available tools.

                                        Available MCP Tools                                  
        ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
        ┃ Tool Name                   ┃ Description                                           ┃
        ┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
        │ show_scheduled_task_summary │ Show most recent related cron log output              │
        │ search_crontab_entries      │ Search for crontab entries containing a specific term │
        │ check_server_status         │ Check the status of the MCP server                    │
        └─────────────────────────────┴───────────────────────────────────────────────────────┘

        Available Commands:
            1. Show recent logs
            2. Search crontab entries
            3. Check server status
            4. Exit
            Enter command number [1/2/3/4] (1): 3
            Checking server status...
            JSON Response:
            {
            "status": "online",
            "server_name": "MCP Crontab Explorer Server",
            "version": "1.0.0",
            "tools_available": 3,
            "pid": 516632,
            "timestamp": "2025-03-24T17:00:04.066705"
            }

            Available Commands:
            1. Show recent logs
            2. Search crontab entries
            3. Check server status
            4. Exit
            Enter command number [1/2/3/4] (1): 4
            Exiting MCP Crontab Explorer. Goodbye!

MCP 一致性

Crontab 浏览器通过以下方式实现模型上下文协议：

• 服务器端 MCP: 使用 FastMCP 库通过 @mcp.tool() 装饰器注册工具
• 工具发现: 实现 /tools 端点，该端点返回可用工具的列表
• 工具执行: 支持通过 HTTP POST 请求调用 /tools/{tool_name} 的工具
• 标准响应格式: 以一致的 JSON 格式返回工具结果

客户端使用标准 HTTP 请求，而不是 MCP 特定的客户端库，使其与任何 HTTP 客户端兼容，同时在服务器端保持核心 MCP 模式。

要求

• fastmcp
• rich
• requests