MCP 等待定时器服务器

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

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

概述

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

解决的问题

MCP 客户端和驱动它们的 AI 模型通常按顺序运行。 在执行命令或操作（例如，Web 请求、文件操作或 API 调用）后，模型可能会立即继续执行下一步。 但是，某些操作需要额外的时间才能完全完成其效果（例如，后台进程完成、Web 页面在 JavaScript 执行后完全呈现、文件系统传播）。

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

解决方案：wait 工具

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

工具： wait

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

使用案例

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

  示例提示：“导航到 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 客户端：

“请在继续之前等待 10 秒钟。”

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

开发人员

此工具是 199 Longevity 的一部分，该组织致力于扩展人类健康和长寿的领域。

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

项目贡献者：Boris Djordjevic

许可证

此项目已获得 MIT 许可证的许可 - 有关详细信息，请参阅 LICENSE 文件。