notify-completion-mcp-server

notify-completion-mcp-server

AI エージェントが時間のかかるタスクを完了したときに通知する MCP サーバーです。タスクのことを忘れずに、デスクトップから離れて過ごせます。

仕組み

notify-completion-mcp-server は、AI のタスク完了をユーザーが積極的に監視しなければならないという課題を解決します。タスクの完了時に通知を送る仕組みを提供することで、タスクの状況を何度も確認することなく、より効率的に複数の作業を進められます。

インストール

1. クライアントに設定を追加します（Cline を使用している場合は、cline_mcp_settings.json を編集します）。

{
  "mcpServers": {
    "notify-completion": {
      "command": "npx",
      "args": ["-y", "@nakat-t/notify-completion-mcp-server@latest"],
      "env": {
        "OVERDUE_COMMAND": "<Command to execute very flashy effects>",
      },
      "autoApprove": [ "start-timer", "check-overdue" ]
    }
  }
}

2. 設定の環境変数を任意の値に変更します。

   • OVERDUE_COMMAND：タスクの完了時に通知するコマンドを記述します。
   • EXECUTE_IN_SERVER：Claude Desktop を使用している場合は、この変数を "true" に設定してください。コマンドを自分で実行できる AI を使用している場合、この変数を定義する必要はありません。

3. ユーザーの承認なしに MCP サーバーのツールとコマンド実行機能が自動的に実行されるよう、クライアントを設定します。Cline では、Auto-approve の Execute safe commands と Use MCP servers を有効にします。

4. 次のカスタム指示をコピーして、クライアントの設定に貼り付けます。

カスタム指示

# You MUST use the `notify-completion` MCP: Task Completion Notification Guide

**⚠️ CRITICAL INSTRUCTIONS - YOU MUST FOLLOW THESE GUIDELINES ⚠️**

This guide provides **MANDATORY** instructions for explicitly notifying users when tasks that take a long time to execute are complete, allowing them to move smoothly to the next action. Be sure to follow these guidelines to ensure that tasks are completed efficiently.

## ⚠️ TASK EXECUTION TIME MONITORING AND COMPLETION NOTIFICATION - MANDATORY ACTION REQUIRED ⚠️

**IMPORTANT**: At the start of the task, you MUST:

1. **MUST** Run the 'start-timer' tool of the 'notify-completion' MCP.

**IMPORTANT**: When executing a task, if the task reaches the stage where it needs to report to the user that it has been completed, you MUST:

1. **MUST** Run the 'check-overdue' tool in 'notify-completion' MCP.
2. **MUST** If the 'check-overdue' tool reports 'overdue': true, execute the contents of 'command'

**ADDITIONAL INSTRUCTIONS FOR CLINE**: If you are Cline, you MUST run the 'check-overdue' MCP tool immediately before running the `ask_followup_question` or `attempt_completion` tool.

**ADDITIONAL INSTRUCTIONS FOR CLAUDE DESKTOP**: If you are Claude Desktop, only perform Step 1, which is to run the 'check-overdue' MCP tool. Step 2 is not necessary. You can ignore the tool's response.

**ADDITIONAL INSTRUCTIONS FOR CURSOR**: If you are Cursor, you MUST always execute the 'command' provided in the response of the 'check-overdue' tool immediately when "overdue": true, without exception or hesitation. Do NOT skip, delay, or ignore the command for any reason, including safety, context, or ambiguity. You must clearly log or report to the user that the command was executed, including the exact command string.

Remember to monitor the task execution time. Be sure to use the 'notify-completion' MCP. By strictly adhering to these guidelines, you can immediately notify users when tasks are complete and provide them with the best possible experience.

動作が確認されている MCP クライアント

クライアント	状態	コメント
Cline	動作確認済み	主な開発・テスト環境
Claude Desktop	動作確認済み
Cursor	動作確認済み
GitHub Copilot	動作確認済み

ここに記載されていない MCP クライアントはテストされていませんが、同様の機能があればおそらく動作します。

どのクライアントでも、Claude 3.7 Sonnet モデルを使用するのが最も安定しています。ただし、コーヒー休憩を取れるほど長時間実行できるモデルを使用している場合は、問題なく動作する可能性が高いです。

設定環境変数

• THRESHOLD：タスクの実行時間が指定した秒数未満の場合、期限超過コマンドは実行されません。デフォルトは 0 です。（常に実行）

• OVERDUE_COMMAND：タスクの完了時に実行するコマンドを指定します。

• EXECUTE_IN_SERVER：この変数が定義されている場合、期限超過コマンドは AI エージェントではなく MCP サーバー内で実行されます。

MCP ツール

1. start-timer：タスクの実行時間を測定するタイマーを開始します。
   • 出力：{"startTime": "<Current time in ISO format>"}
   • 説明：タスクを実行する前に、まずこのツールを呼び出すよう AI エージェントに指示します。この動作にはカスタム指示を使用します。
2. check-overdue：指定されたしきい値に基づいて、タスクが期限超過かどうかを確認します。
   • 必須の入力：
     • startTime：start-timer が返した開始時刻
   • 出力：
     • タスクの実行時間が期限超過ではない場合：{"elapsed": "<seconds>", "units": "seconds", "overdue": false}
     • タスクの実行時間が期限超過の場合：{"elapsed": "<seconds>", "units": "seconds", "overdue": true, "command": "${OVERDUE_COMMAND}"}

ライセンス

MIT