Wait Timer

🚀 MCP 等待计时器服务器

MCP 等待计时器服务器是一个 MCP（模型上下文协议）服务器，它提供了一个简单的 wait 工具，可在工作流程中引入故意的暂停，解决因异步操作未完成而导致的执行错误问题。

观看演示视频：https://www.youtube.com/watch?v=TaF_j9wrWVw

🚀 快速开始

此服务器需要 Node.js（版本 16 或更高）。下面为你介绍具体的安装与使用步骤：

步骤 1: 配置您的 MCP 客户端

在您客户端的配置文件中添加以下 JSON 内容。将 your-environment-path 替换为实际环境路径。

{
    "mcp": {
        "servers": [
            {
                "url": "http://localhost:3000",
                "name": "等待计时器服务器",
                "description": "用于在 MCP 工作流程中添加等待延迟的工具。",
                "icon": "alarm-clock",
                "environment": "your-environment-path"
            }
        ]
    }
}

步骤 2: 启动 MCP 客户端

运行以下命令启动您的 MCP 客户端：

mcp-client start

步骤 3: 使用 wait 工具

在您的工作流程中使用 wait 工具，例如：

const { wait } = require('@your-mcp/environment');

// 等待 5 秒
await wait(5000);

✨ 主要特性

此服务器公开了一个单一工具 wait，旨在在工作流程中引入故意的暂停。这些工作流程由 MCP 客户端（例如 Cline、Claude Desktop、Cursor）执行。该工具可解决 MCP 客户端和 AI 模型在执行异步操作时可能出现的过早继续执行问题，确保依赖时间的操作有足够的时间完成。

📚 详细文档

解决的问题

MCP 客户端和驱动它们的 AI 模型通常按顺序运行。在执行命令或操作（如网页请求、文件操作或 API 调用）后，模型可能会立即进行下一步。然而，某些操作需要额外的时间才能完成其异步效果（例如背景进程完成、JavaScript 执行后网页完全加载、文件系统传播）。由于模型无法始终可靠地检测这些异步效果是否完成，它可能会过早地继续执行，导致错误或后续步骤中的不正确假设。

解决方案：wait 工具

此服务器提供了一个 wait 工具，允许用户或 AI 提示明确指示客户端暂停指定的时间，然后再继续。这确保了依赖时间的操作有足够的时间完成。 工具：wait

• 描述：暂停执行指定的秒数。
• 输入参数：
  • duration_seconds (数字，必填)：等待的持续时间，以秒为单位。必须是正数。

使用场景

• Web 自动化：确保动态内容加载或脚本在页面导航或元素交互后完成执行。

  示例提示: "访问 example.com，填写登录表单，点击提交，然后等待 5 秒并捕获截图。"
  

• 命令行操作：允许时间让背景任务、文件写入或服务启动完成。

  示例提示: "运行 'npm run build'，等待 15 秒，然后检查 'dist/app.js' 文件是否存在。"
  

• API 交互：在 API 调用之间添加延迟以处理速率限制或等待异步作业完成。
• 工作流调试：在复杂任务的特定点插入暂停以观察系统状态。

📄 许可证

该项目根据 MIT 许可证发布 - 有关详细信息，请参阅 LICENSE 文件。

项目背景

此项目由 199 长寿 实施，该组织专注于扩展人类健康和长寿的边界。了解我们更多在生物技术领域的研究：199 生物。项目贡献者：Boris Djordjevic