healthchecks-io-mcp

@digitalronin/healthchecks-io-mcp

Healthchecks.io とは無関係の非公式プロジェクトです。 これはサードパーティ製の MCP サーバーであり、Healthchecks.io の公式製品ではありません。

これは何ですか

Healthchecks.io は、「デッドマンスイッチ」型の 監視サービスです。スケジュールに従って実行されるジョブ（cron ジョブ、バックアップ、バッチスクリプトなど、 定期的に実行されるもの）は、実行時に Healthchecks.io に ping を送信します。 予定どおりに ping が届かない場合、Healthchecks.io は通知します。つまり、 ジョブが気付かれないまま失敗したか、実行されなかったことを知らせてくれます。

このパッケージは MCP サーバー です。Claude のような AI アシスタントが、ユーザーに代わって Healthchecks.io の Management API を利用できるようにする小さなローカルプログラムです。セットアップが完了すると、 AI アシスタントに「Healthchecks.io のチェックを一覧表示して」 「バックアップジョブの ping 履歴を見せて」「ステージング環境の監視を一時停止して」 などと平易な言葉で頼むだけで、適切な Healthchecks.io API エンドポイントを呼び出してくれます。

セットアップ

1. Healthchecks.io API キーを取得する

1. healthchecks.io にログインします（または、 下記のセルフホストインスタンスにログインします）。
2. プロジェクトの Settings ページを開き、API Access タブを選択します。
3. read-only キーと read-write キーの 2 つが表示されます。
   • read-only キーではチェックを参照できますが、作成、変更、一時停止、削除はできません。
   • read-write キーでは、read-only キーでできるすべての操作に加えて、チェックの作成、更新、一時停止、再開、および 完全な削除 ができます。

2. このサーバーを MCP クライアントの設定に追加する

手動で何かをインストールする必要はありません。初回使用時に npx が自動的にダウンロードして実行します。 以下のブロックを MCP クライアントの設定に追加してください（Claude Code の場合は .mcp.json ファイルを使います。他の クライアントでは、独自の設定ファイルまたは UI を使用します）。

{
  "mcpServers": {
    "healthchecks-io": {
      "command": "npx",
      "args": ["@digitalronin/healthchecks-io-mcp"],
      "env": {
        "HEALTHCHECKS_API_KEY": "your-key-here"
      }
    }
  }
}

"your-key-here" を手順 1 で取得した API キーに置き換えます。保存した後、MCP クライアントを再起動するか、MCP 接続を再読み込みしてください。ほとんどのクライアントでは、 新しいサーバーや変更されたサーバーが反映されるのは再起動後です。

3. 試してみる

接続したら、AI アシスタントに次のように頼んでみてください。

• 「Healthchecks.io のチェックをすべて一覧表示して」
• 「nightly-backup チェックの ping 履歴を見せて」
• 「staging-cron チェックは現在失敗していますか？」

アカウントの実データが返ってくれば、正しくセットアップできています。

任意：複数のプロジェクト

Healthchecks.io の API キーはプロジェクトごとに設定されるため、1 つのサーバーエントリで操作できるのは 1 つのプロジェクトだけです。 複数のプロジェクトを扱うには、サーバーを異なる名前で複数回登録し、それぞれに独自のキーを設定します。

{
  "mcpServers": {
    "healthchecks-io-personal": {
      "command": "npx",
      "args": ["@digitalronin/healthchecks-io-mcp"],
      "env": {
        "HEALTHCHECKS_API_KEY": "personal-project-key-here"
      }
    },
    "healthchecks-io-work": {
      "command": "npx",
      "args": ["@digitalronin/healthchecks-io-mcp"],
      "env": {
        "HEALTHCHECKS_API_KEY": "work-project-key-here"
      }
    }
  }
}

各エントリは 1 つのキーを保持する独自のプロセスを実行し、MCP クライアントはサーバー名ごとにツールを名前空間化するため、ツール呼び出しがどのプロジェクトを対象としているかを判別できます。

任意：セルフホストの Healthchecks.io

Healthchecks.io はオープンソースであり、ホスト型 SaaS サービスの healthchecks.io を使わずに、 独自のインスタンスを運用している人もいます。その場合は、インスタンスの API ルートを指定する環境変数を追加します。

"env": {
  "HEALTHCHECKS_API_KEY": "your-key-here",
  "HEALTHCHECKS_BASE_URL": "https://monitoring.example.com/api/v3"
}

URL には、/api/v3 のパスセグメントを 含む完全な API ルート を指定し、 末尾にスラッシュを 付けないでください。例： https://monitoring.example.com/api/v3。https://monitoring.example.com や https://monitoring.example.com/api/v3/ ではありません。ここを間違えると、 サーバーが /checks/ などのパスを指定した値に直接追加するため、すべてのツール呼び出しが 「not found」エラーで失敗します。HEALTHCHECKS_BASE_URL を設定しない場合は、 実際の https://healthchecks.io/api/v3 がデフォルトで使用されます。

セルフホストインスタンスが HTTPS の背後にない場合、サーバーは警告を表示します（ただし、実行は継続します）。 API キーはすべての呼び出しでリクエストヘッダーとして送信されるため、 http:// URL を指定すると、そのキーはネットワーク経由で平文のままインスタンスに送信されます。

できること

このサーバーは、AI アシスタントが呼び出せる 11 個の「ツール」を公開します。これらは 2 つのグループに分かれています。

読み取りツール — 安全な参照専用のツールで、何も変更しません。

ツール	機能
list_checks	アカウント内のすべてのチェックを一覧表示します。
get_check	特定のチェックの詳細をすべて取得します。
list_check_pings	チェックの最近の ping 履歴を表示します（ping を受信した時刻、成功／失敗など）。 読み書きキーが必要です — 下記の注記をご覧ください。
list_check_flips	チェックのステータスが変更されたタイミングを表示します（例：正常から失敗に変わった場合や、その逆の場合）。
list_integrations	設定済みの通知インテグレーション（Slack、メールなど）を一覧表示します。 読み書きキーが必要です — 下記の注記をご覧ください。
list_badges	Healthchecks.io がタグごとに生成するバッジ画像の URL を取得します（ステータスページやダッシュボードに便利です）。

変更ツール — アカウント内の設定を変更します。すべてのツールで読み書き API キーが必要です。

ツール	機能
create_check	新しいチェックを作成します（例：「24 時間ごとの ping を想定する nightly-backup というチェックを作成する」）。既存のフィールド（チェック名など）と照合し、重複を作成する代わりに該当するチェックを更新するよう指定することもできます。ジョブが複数回登録される可能性がある場合に便利です。
update_check	既存のチェックの設定を変更します。指定したフィールドのみが変更され、指定しなかった項目はそのまま維持されます。
pause_check	チェックを削除せずに、一時的に監視を停止します。明示的な確認が必要です — 下記をご覧ください。
resume_check	一時停止中のチェックの監視を再開します。
delete_check	チェックを完全に削除します — この操作は取り消せません。明示的な確認が必要です — 下記をご覧ください。

技術リファレンス

各ツールが使用する Healthchecks.io API エンドポイントを以下の表に示します。

ツール	読み書きキーが必要ですか？	Healthchecks.io API エンドポイント
list_checks	いいえ	GET /api/v3/checks/
get_check	いいえ	GET /api/v3/checks/{uuid}
list_check_pings	はい	GET /api/v3/checks/{uuid}/pings/
list_check_flips	いいえ	GET /api/v3/checks/{uuid}/flips/
list_integrations	はい	GET /api/v3/channels/
list_badges	いいえ	GET /api/v3/badges/
create_check	はい	POST /api/v3/checks/
update_check	はい	POST /api/v3/checks/{uuid}
pause_check	はい	POST /api/v3/checks/{uuid}/pause
resume_check	はい	POST /api/v3/checks/{uuid}/resume
delete_check	はい	DELETE /api/v3/checks/{uuid}