MCP Wait Server

MCP Wait サーバー

Claude Desktop やその他の MCP クライアント向けに、時間関連のツールを提供するシンプルな Model Context Protocol サーバーです。

• 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. wait と get_datetime のツールが Claude Desktop で使用できるようになります

環境変数

• MCP_WAIT_MAX_DURATION_SECONDS - 1 回の待機呼び出しにおける最大時間（デフォルト：210 秒）
• MCP_WAIT_TOOL_DESCRIPTION - wait ツールのカスタム説明

仕組み

Wait ツール

Claude に wait ツールが与えられると、指定した秒数だけ待機するために使用できます。特に、次のような状況で便利です。

• 時間のかかるスクリプトが完了するまで待つ
• プロセスのステータスを確認する前に一時停止する
• API 呼び出しの間に遅延を追加して、レート制限を回避する
• ダウンロードやアップロードが完了するまで時間を置く

1 回の待機時間には上限（デフォルトでは 210 秒）がありますが、それより長い待機は、残り時間を指定して再度呼び出すよう Claude に指示し、自動的に処理します。

Get DateTime ツール

get_datetime ツールは、ISO 8601 形式で現在の日付と時刻を提供します。次のような用途に便利です。

• 操作やイベントにタイムスタンプを付ける
• 時間差を計算する
• スケジュール設定や時間に基づく意思決定を行う
• 正確なタイムスタンプを使ってログを記録する

開発

• Node.js 18 以降が必要です
• 依存関係をインストールします：npm install
• ビルドします：npm run build
• 実行します：npm start