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.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/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ファイルを参照してください。