项目简介

通知完成MCP服务器是一个后台服务，旨在解决用户需要持续监控长时间运行的AI任务完成状态的问题。通过集成到兼容的LLM客户端，此服务器允许AI在任务达到完成阶段时触发自动通知，让用户可以专注于其他工作。

主要功能点

任务计时: 启动一个内部计时器来跟踪AI任务开始执行的时间。
检查超时/完成: 检查任务是否已运行超过设定的时间阈值。当任务完成后（通常意味着已经“超时”），服务器会准备通知。
触发通知命令: 如果任务完成（标记为“overdue”），服务器会提供一个预设的通知命令。这个命令可以由AI客户端执行（例如，在终端弹出通知），或者根据配置直接在服务器端执行。

安装步骤

本服务器通常由你的MCP兼容LLM客户端自动下载和管理。你只需要在客户端的MCP服务器设置中添加配置信息即可。

服务器配置

在你的LLM客户端的MCP服务器配置中，你需要添加一个条目来定义如何启动和连接到此服务器。配置通常包含服务器名称、启动命令和参数。以下是你需要的信息（请根据你的客户端的具体JSON或UI格式进行配置）：

你还可以设置以下环境变量来配置服务器的行为（这些需要在客户端启动服务器的环境中设置，具体设置方式取决于你的客户端）：

'THRESHOLD': 一个时间阈值（秒）。任务执行时间超过此值才被认为是“overdue”。默认值为 0（总是视为overdue）。
'OVERDUE_COMMAND': 当任务“overdue”时要执行的系统命令字符串。例如，一个在终端显示通知的命令。
'EXECUTE_IN_SERVER': 如果设置为 '"true"'，则 'OVERDUE_COMMAND' 将在MCP服务器运行的环境中执行，而不是由AI客户端执行。

你还需要在客户端设置中允许AI自动调用此服务器提供的工具，并可能允许自动执行服务器返回的命令，以便通知功能可以自动触发。

基本使用方法

配置好服务器并将其添加到你的客户端后，你需要更新你的LLM的系统提示或自定义指令。指导AI：

在开始一个可能耗时的任务之前，调用 'notify-completion' 服务器的 'start-timer' 工具。
在认为任务完成、需要向用户报告结果之前，调用 'notify-completion' 服务器的 'check-overdue' 工具，并提供 'start-timer' 返回的开始时间。
如果 'check-overdue' 返回的结果中 'overdue' 字段为 'true' 并包含一个 'command' 字段，则根据客户端的能力和配置执行该 'command' 来通知用户。

关键词