MCP Wait Server

MCP Wait 服务

简单的模型上下文协议服务，为 Claude Desktop 和其他 MCP 客户端提供时间相关工具：

• wait - 暂停执行指定秒数，适用于需要等待长时间运行的操作完成的情况
• get_datetime - 以 ISO 8601 格式返回当前日期和时间

实现

• 使用 TypeScript 编写
• 位于 src/index.ts（源代码）和 build/index.js（编译后）
• 使用以下命令运行：npm start，或直接运行 node build/index.js

安装

选项 1：使用 npx（推荐——无需安装）

最简单的方法是使用 npx 运行软件包，无需安装。按照下方“用法”部分的说明配置 Claude Desktop。

选项 2：从 npm 安装

如果你希望安装此软件包：

# Install globally
npm install -g mcp-wait-server

选项 3：克隆并从源代码构建

用于开发或自定义：

# Clone repository
git clone https://github.com/Amico1285/mcp-wait-server.git
cd mcp-wait-server

# Install dependencies
npm install

# Build the project
npm run build

# You can run it directly
npm start

在 Claude Desktop 中使用

1. 创建或编辑 Claude Desktop 配置文件：

   • macOS/Linux 上的位置：~/.anthropic/config.json
   • Windows 上的位置：%APPDATA%\anthropic\config.json
   • 如有需要，请创建目录/文件

2. 推荐方法：使用 npx（无需安装）

这是适用于所有环境的最简单方法，无需全局安装：

{
  "mcpServers": {
    "wait_server": {
      "command": "npx",
      "args": [
        "mcp-wait-server@latest"
      ],
      "env": {
        "MCP_WAIT_MAX_DURATION_SECONDS": "210",
        "MCP_WAIT_TOOL_DESCRIPTION": "Waits for a specified number of seconds. Use this to create a delay after starting a long-running operation (like a script or download via another tool), allowing it time to complete before you proceed or check its status."
      }
    }
  }
}

3. 其他方法：

如果你进行了全局安装：

{
  "mcpServers": {
    "wait_server": {
      "command": "mcp-wait-server",
      "env": {
        "MCP_WAIT_MAX_DURATION_SECONDS": "210",
        "MCP_WAIT_TOOL_DESCRIPTION": "Waits for a specified number of seconds. Use this to create a delay after starting a long-running operation (like a script or download via another tool), allowing it time to complete before you proceed or check its status."
      }
    }
  }
}

如果你从源代码安装：

{
  "mcpServers": {
    "wait_server": {
      "command": "/path/to/your/mcp-wait-server/build/index.js",
      "env": {
        "MCP_WAIT_MAX_DURATION_SECONDS": "210",
        "MCP_WAIT_TOOL_DESCRIPTION": "Waits for a specified number of seconds. Use this to create a delay after starting a long-running operation (like a script or download via another tool), allowing it time to complete before you proceed or check its status."
      }
    }
  }
}

4. 重启 Claude Desktop

5. Claude Desktop 现在即可使用 wait 和 get_datetime 工具

环境变量

• MCP_WAIT_MAX_DURATION_SECONDS - 单次等待调用的最长时间（默认值：210 秒）
• MCP_WAIT_TOOL_DESCRIPTION - 自定义 wait 工具的描述

工作原理

Wait 工具

为 Claude 提供 wait 工具后，它便可使用该工具等待指定秒数。这在以下场景中特别有用：

• 等待长时间运行的脚本完成
• 在检查进程状态前暂停
• 在 API 调用之间增加延迟，以避免触发速率限制
• 留出时间等待下载或上传完成

该工具的单次最长等待时间有限（默认值为 210 秒），但会自动处理更长的等待时间，方法是指示 Claude 使用剩余时间再次调用该工具。

Get DateTime 工具

get_datetime 工具以 ISO 8601 格式提供当前日期和时间。适用于：

• 为操作或事件添加时间戳
• 计算时间差
• 安排计划或进行基于时间的决策
• 使用准确的时间戳记录日志

开发

• 需要 Node.js 18+
• 安装依赖项：npm install
• 构建：npm run build
• 运行：npm start