MCP Wait Timer Server
MCP 待機タイマーサーバー
シンプルなwaitツールを提供する MCP (Model Context Protocol) サーバー。
デモビデオを見る: https://www.youtube.com/watch?v=TaF_j9wrWVw
概要
このサーバーは、MCP クライアント (Cline、Claude Desktop、Cursor など) によって実行されるワークフローに意図的な一時停止を導入するように設計された単一のツールwaitを公開します。
Related MCP server: mcp-sleep
問題解決
MCPクライアントとそれを駆動するAIモデルは、多くの場合、順次動作します。コマンドまたはアクション(Webリクエスト、ファイル操作、API呼び出しなど)を実行した後、モデルはすぐに次のステップに進む場合があります。ただし、一部のアクションは、その効果を完全に完了させるまでに追加の時間を必要とします(例:バックグラウンドプロセスの終了、JavaScript実行後のWebページの完全なレンダリング、ファイルシステムへの伝播)。
モデルは、これらの非同期効果が完了した時点を常に確実に検出できるとは限らないため、処理が早まって進み、後続のステップでエラーが発生したり、誤った仮定が生じたりする可能性があります。
解決策: waitツール
このサーバーは、ユーザーまたはAIプロンプトがクライアントに対し、処理を続行する前に指定時間だけ一時停止するよう明示的に指示できるwaitツールを提供します。これにより、時間依存の操作が完了するのに十分な時間を確保できます。
ツール: wait
**説明:**指定された秒数の間、実行を一時停止します。
入力パラメータ:
duration_seconds(数値、必須): 待機時間(秒数)。正の数値でなければなりません。
ユースケース
**Web オートメーション:**ページナビゲーションまたは要素のインタラクションの後に、動的コンテンツの読み込みまたはスクリプトの実行が完了することを確認します。
Example Prompt: "Navigate to example.com, fill the login form, click submit, then wait for 5 seconds and capture a screenshot."**コマンドライン操作:**シェル コマンドによって開始されるバックグラウンド タスク、ファイル書き込み、またはサービスの起動に時間をかけます。
Example Prompt: "Run 'npm run build', wait for 15 seconds, then check if the 'dist/app.js' file exists."**API インタラクション:**レート制限を処理するために、または非同期ジョブの完了を待機するために、API 呼び出し間に遅延を追加します。
**ワークフローのデバッグ:**複雑なタスク中の特定のポイントでシステムの状態を観察するために一時停止を挿入します。
インストールとセットアップ
このサーバーには Node.js (バージョン 16 以上) が必要です。
ステップ1: MCPクライアントを構成する
クライアントの設定ファイル内の"mcpServers": {}オブジェクト内に、以下のJSONブロックを追加してください。クライアントとオペレーティングシステムに対応するファイルを選択してください。
構成ブロック:
"wait-timer": {
"command": "npx",
"args": ["mcp-wait-timer"],
"env": {},
"disabled": false,
"autoApprove": []
}クライアント構成ファイルの場所:
クロードデスクトップ:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.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.jsonWindows:
%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.jsonLinux:
~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
カーソル:
グローバル:
~/.cursor/mcp.jsonプロジェクト固有: プロジェクト フォルダー内に
.cursor/mcp.jsonファイルを作成します。
ウィンドサーフィン:
~/.codeium/windsurf/mcp_config.json
その他のクライアント:
MCP設定ファイルの場所については、各クライアントのドキュメントを参照してください。上記の「設定ブロック」に示されているJSON構造は、通常問題なく動作するはずです。
ステップ2: クライアントを再起動する
設定ブロックを追加してファイルを保存したら、変更を有効にするためにMCPクライアントアプリケーションを完全に再起動してください。クライアントが初めてサーバーを起動すると、 npx mcp-wait-timerパッケージがキャッシュされていない場合は自動的にダウンロードします。
使用例
インストールして有効にしたら、MCP クライアントに次の指示を与えることができます。
"Please wait for 10 seconds before proceeding."クライアントの AI モデルはインテントを認識し、 duration_seconds: 10でwaitツールを呼び出す必要があります。
開発者
このツールは、人間の健康と寿命の限界を広げることに重点を置くグループである199 Longevityの取り組みの一環として開発されました。
バイオテクノロジー分野における当社の取り組みの詳細については、 199.bioをご覧ください。
プロジェクト貢献者: ボリス・ジョルジェビッチ
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。
Available Tools
1 toolwaitA
Waits for a specified duration in seconds.
| Name | Required | Description | Default |
|---|---|---|---|
| duration_seconds | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the action ('waits') but does not explain how the wait is implemented (e.g., blocking vs. non-blocking), potential side effects, or error handling. This leaves gaps in understanding the tool's behavior beyond the basic action.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, clear sentence that efficiently conveys the tool's function without unnecessary details. It is front-loaded and wastes no words, making it easy to understand at a glance.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's low complexity (one parameter, no output schema, no annotations), the description is minimally adequate but lacks depth. It covers the basic action but does not address behavioral aspects like implementation details or error scenarios, which could be important for a wait function in some contexts.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description adds meaning by specifying that the parameter is for 'duration in seconds,' which clarifies the unit and purpose beyond the schema's description ('The number of seconds to wait'). With 0% schema description coverage, the description compensates well by providing essential context, though it could note the minimum value constraint from the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose with a specific verb ('waits') and resource ('duration in seconds'), making it immediately understandable. It distinguishes itself by focusing solely on time-based waiting functionality, which is straightforward given there are no sibling tools to differentiate from.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for delaying execution by a specified time, but provides no explicit guidance on when to use this tool versus alternatives or any prerequisites. With no sibling tools, the context is limited, but it lacks details on scenarios where waiting is appropriate or any constraints.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
1 tool update
v1.0.0- First observed
wait
TDQS
Scored across 1 tool
With only one tool, there is no possibility for ambiguity or overlap between tools. The tool 'wait' has a single, clear purpose that cannot be confused with any other tool in this set.
The naming is trivially consistent as there is only one tool. The tool name 'wait' follows a simple verb pattern, and there are no other tools to create inconsistency or mixed conventions.
A single tool is too few for most server purposes, making the server feel thin and limited in scope. While a timer server might logically have few tools, one tool is borderline minimal and may not cover all expected timer-related operations, such as cancelling or listing waits.
The tool set is severely incomplete for a timer server. It only provides a wait function, missing obvious operations like cancelling an active wait, checking wait status, or managing multiple timers, which are common in timer-related domains.
Maintenance
Related MCP Connectors
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Concierge MCP for agentic workflows: verified time + drift, uuid, diff, calc, attest, verify.
Hosted MCP runtime where your agent publishes its own tools by tool call and keeps working.
Related MCP Servers
- AlicenseBqualityDmaintenanceA Model Context Protocol (MCP) server that provides a simple sleep/wait tool, useful for adding delays between operations such as waiting between API calls or testing eventually consistent systems.16 npm23ISC
- AlicenseBqualityDmaintenanceTool that allows you to wait a certain time to continue the execution of an agent.11Apache 2.0
- AlicenseBqualityDmaintenanceA simple MCP server that provides waiting functionality to pause until other tasks finish, with progress reporting and support for CLI or HTTP server with SSE.123 npm5MIT
- AlicenseNot gradedqualityDmaintenanceProvides a wait tool for AI agents to pause execution until a time duration elapses or a process terminates, useful for polling and waiting for builds/deployments.10 npmMIT