Wait Timer

🚀 MCP Wait Timer Server

An MCP (Model Context Protocol) server that provides a simple wait tool.

Watch the demo video: https://www.youtube.com/watch?v=TaF_j9wrWVw

🚀 Quick Start

Overview

This server exposes a single tool, wait, designed to introduce intentional pauses in workflows executed by MCP clients (e.g., Cline, Claude Desktop, Cursor).

Problem Solved

MCP clients and the AI models driving them typically run sequentially. After executing a command or operation (such as a web request, file operation, or API call), the model may immediately proceed to the next step. However, some operations require additional time to complete their asynchronous effects (e.g., background processes finishing, web pages fully loading after JavaScript execution, file system propagation).

Since the model cannot always reliably detect whether these asynchronous effects are complete, it may proceed prematurely, leading to errors or incorrect assumptions in subsequent steps.

Solution: The wait Tool

This server provides a wait tool that allows users or AI prompts to explicitly instruct the client to pause for a specified amount of time before continuing. This ensures that time-dependent operations have sufficient time to complete.

Tool: wait

• Description: Pause execution for the specified number of seconds.
• Input Parameters:
  • duration_seconds (number, required): The duration to wait, in seconds. Must be a positive number.

Use Cases

• Web Automation: Ensure that dynamic content loads or scripts finish executing after page navigation or element interaction.

Example prompt: "Visit example.com, fill out the login form, click submit, then wait for 5 seconds and capture a screenshot."

• Command-Line Operations: Allow time for background tasks, file writes, or service startups to complete.

Example prompt: "Run 'npm run build', wait for 15 seconds, then check if the 'dist/app.js' file exists."

• API Interaction: Add delays between API calls to handle rate limits or wait for asynchronous jobs to complete.
• Workflow Debugging: Insert pauses at specific points in complex tasks to observe the system state.

Installation and Setup

This server requires Node.js (version 16 or higher).

Step 1: Configure Your MCP Client

Add the following JSON content to your client's configuration file. Replace your-environment-path with the actual environment path.

{
    "mcp": {
        "servers": [
            {
                "url": "http://localhost:3000",
                "name": "Wait Timer Server",
                "description": "A tool for adding wait delays in MCP workflows.",
                "icon": "alarm-clock",
                "environment": "your-environment-path"
            }
        ]
    }
}

Step 2: Start the MCP Client

Run the following command to start your MCP client:

mcp-client start

Step 3: Use the wait Tool

Use the wait tool in your workflow, for example:

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

// Wait for 5 seconds
await wait(5000);

✨ Features

This server mainly provides a wait tool, which can effectively solve the problem of asynchronous operation completion time in MCP client workflows, ensuring the correct execution of subsequent steps.

📚 Documentation

Project Background

This project is implemented by 199 Longevity, an organization focused on expanding the boundaries of human health and longevity.

Learn more about our research in the biotechnology field: 199 Bio.

Project contributor: Boris Djordjevic

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.