MCP 等待计时器服务器

一个提供简单 wait 工具的 MCP（模型上下文协议）服务器。

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

概述

该服务器公开了一个名为 wait 的工具，旨在为由 MCP 客户端（例如 Cline、Claude Desktop、Cursor）执行的工作流引入有意的暂停。

解决的问题

MCP 客户端及其驱动的 AI 模型通常按顺序操作。在执行命令或动作（如网络请求、文件操作或 API 调用）后，模型可能会立即进入下一步。然而，某些动作需要额外的时间才能完全完成其效果（例如，后台进程完成、JavaScript 执行后网页完全渲染、文件系统传播）。

由于模型无法总是可靠地检测到这些异步效果何时完成，它可能会过早地继续执行，从而导致后续步骤中出现错误或不正确的假设。

解决方案：wait 工具

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

工具： wait

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

使用案例

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

  示例提示：“导航到 example.com，填写登录表单，点击提交，然后等待 5 秒并截取屏幕截图。”
  

• 命令行操作： 为通过 shell 命令启动的后台任务、文件写入或服务启动留出时间。

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

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

安装与设置

此服务器需要 Node.js（版本 16 或更高）。

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

在您客户端配置文件中的 "mcpServers": {} 对象内添加以下 JSON 块。选择与您的客户端和操作系统相对应的文件：

配置块：

    "wait-timer": {
      "command": "npx",
      "args": ["mcp-wait-timer"],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }

客户端配置文件位置：

• Claude Desktop:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json (路径可能略有不同)

• VS Code 扩展 (Cline / "Claude Code"):

  • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  • Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
  • Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

• Cursor:

  • 全局: ~/.cursor/mcp.json
  • 项目特定: 在你的项目文件夹内创建一个 .cursor/mcp.json 文件。

• Windsurf:

  • ~/.codeium/windsurf/mcp_config.json

• 其他客户端:

  • 请查阅特定客户端的文档以了解其 MCP 配置文件的位置。上面“配置块”中显示的 JSON 结构通常适用。

步骤 2: 重启客户端

在添加配置块并保存文件后，完全重启你的 MCP 客户端应用程序以使更改生效。第一次启动服务器时，如果 mcp-wait-timer 包尚未缓存，npx 会自动下载该包。

使用示例

安装并启用后，你可以指示你的 MCP 客户端：

"Please wait for 10 seconds before proceeding."

客户端的 AI 模型应识别意图并调用 wait 工具，参数为 duration_seconds: 10。

开发者

此工具是由 199 Longevity 的倡议开发的，这是一个专注于扩展人类健康和长寿边界的团队。

了解更多关于我们在生物技术方面的工作，请访问 199.bio。

项目贡献者：Boris Djordjevic

许可证

本项目根据 MIT 许可证发布 - 详情请参阅 LICENSE 文件。