snag-list-defect-handover-signoff

mcp-checklist

公式 MCP Registry に登録されています（io.github.theluckystrike/checklist）。 一度作成すれば何度でも実行でき、各実行には日付入りの記録が残り、担当者が署名できます。チェックリストは名前付きの手順リストで、任意でセクションにまとめられ、各手順は必須または任意に設定できます。実行とは、作業に対してそのチェックリストを一通り確認することです。各手順には合格、不合格、または該当なしのいずれかが記録され、誰がいつ記録したのか、そして何が見つかったかを示すメモも残ります。run_sign_off を実行すると、名前と日付が記録され、内容が固定されます。

ほかのすべてを決める唯一のルール

誰かが後からチェックリストを編集して、 手順を追加したり削除したりしても、すでに進行中の実行には開始時のリストがそのまま残り、 どのバージョンをコピーしたかが実行記録に残ります。

これは単なるキャッシュ上の利便性ではありません。誰かがチェックして署名したチェックリストは、その人が実際に目にしたリストでなければなりません。実行時にチェックリストから手順を都度読み込むと、署名した人が10項目を確認したのに、署名済みの引き継ぎ証明書には11項目の確認が記録され、その事実を示すフィールドが記録にない、ということになりかねません。また、チェックリストを削除しても実行記録は読み取り可能で、内容も完全なままです。1年後に何が確認されたか尋ねられたときにも、それが望ましい状態です。

ここから、次の2つの小さなルールが導かれます。

• 派生データは保存しません。 合格、不合格、未完了の件数、割合、そして実行に署名できるかどうかは、呼び出しのたびに実行自体の手順から算出されます。保存された「完了」フラグは、最後に確認したときの状態にすぎません。一方、ここでの complete は読み取り時に算出される値です。最後の手順に回答すると表示され、再び保留に戻すと表示されなくなります。
• 該当なしは合格ではありません。 na は回答済みとしてカウントされますが、合格にはカウントされません。確認したうえで該当なしと判断した手順は、合格した手順とは別の事実です。この2つをまとめると、手順の半分が該当しなかった作業でも、チェックリストが満点を報告してしまいます。

署名を妨げる条件

必須手順が未回答であること、必須手順が不合格であること、任意手順が未回答であること、または手順が1つもない実行です。force: true を指定すればそのまま署名でき、例外は記録に残り、レポートの「例外ありで署名済み」の欄に表示されます。失われることも、記録されずに済まされることもありません。

インストール

ワンクリック（.mcpb）：最新リリースから checklist.mcpb をダウンロードし、 Claude Desktop でダブルクリックします：https://github.com/theluckystrike/mcp-servers/releases/latest

@theluckystrike/mcp-checklist の npm 公開は保留中のため、以下の npx の行は現時点では 404 を返します。それまではソースからビルドしてください。llms-install.md を参照してください。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "checklist": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-checklist"]
    }
  }
}

Claude Code

claude mcp add checklist -- npx -y @theluckystrike/mcp-checklist

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト）。Claude Desktop と同じエントリーを使用します。

ツール

ツール	機能
checklist_create	再利用可能なチェックリストを作成します。名前、カテゴリ、説明を指定します
checklist_item_add	手順を追加します。テキスト、セクション見出し、必須かどうかを指定します
checklist_item_remove	手順を削除して、バージョンを更新します。進行中の実行にはその手順が残ります
checklist_show	1つのチェックリストをセクションごとにまとめて表示します。リクエストに応じて、印刷用の空白のコピーも表示します
checklist_list	すべてのチェックリストについて、バージョン、手順数、それをもとにした実行回数を表示します
checklist_delete	チェックリストを削除します。各実行にはそれぞれ独自のコピーがあるため、実行内容は引き続き確認できます
run_start	日付を付けて、作業に対する実行を開始します。この時点で手順が実行にコピーされます
run_check	1つの手順を合格、不合格、または該当なしとして記録します。担当者、日時、確認内容も記録します
run_show	実行内容を表示します。各手順の回答、件数、不合格項目、承認を妨げている項目が含まれます
run_list	新しい順に実行を表示します。チェックリスト、ステータス、参照情報で絞り込むか、不合格項目があるものだけを表示します
run_sign_off	名前と日付を指定して承認し、実行内容を確定します
run_status	完了した実行を再開するか、作業が実施されなかった場合に実行を中止します
run_report	すべてのティアで実行内容をテキストとして表示します。Proでは、out_path に .txt ファイルとしても書き込みます
run_delete	実行を削除します。承認済みの実行は削除できません
license_status	このインストールのティアと、キーの入手元を表示します
license_activate	このサーバーに Pro キーを保存します

また、スナップショットのルール、項目の状態、実行のステータス遷移、承認を妨げる条件、このサーバーの書き込み先を記載したリソース checklist://contract と、作業全体を順番に進めるプロンプト run_the_checklist があります。

Free と Pro の違い

	Free	Pro
保持できるチェックリスト数	3	無制限
チェックリストの実行回数	無制限	無制限
チェックリストあたりの手順数	最大 500	最大 500
run_show、run_list、件数	はい	はい
実行レポートのテキスト表示	はい	はい
out_path を指定したレポートのファイルへの書き込み	いいえ	はい

上限の対象は、チェックする作業の数ではなく、保持しているチェックリストの種類の数です。納品前チェック、引き渡しシート、手直しリストをそれぞれ1つずつ持つ業者であれば、1年を通して Free ティアで運用できます。チェックリストを実行することこそがチェックリストの本来の目的であるため、実行回数に上限はありません。チェックリストを削除すると、枠が1つ空きます。

Pro の購入はこちら：https://mcp.zovo.one/buy/checklist（買い切り）、または、すべてのサーバーを1つの価格で利用する場合はこちら：https://mcp.zovo.one/buy/bundle

プライバシー

すべてのデータは ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/checklist/ 内にローカル保存されます。このサーバーはネットワーク接続を一切行わず、API キーやアカウントも必要ありません。このサーバーが所有していないファイルで読み取るのは共有ビジネスプロフィールのみです。印刷レポートの冒頭に記載する名前と住所を取得するために読み取りますが、そのファイルに書き込むことはありません。

theluckystrike が開発しました。サポート：[email protected]

このドキュメントを MCP サーバーとして使用する

任意の MCP クライアント（Claude、Cursor、Windsurf、VS Code）から、インストールなしで GitMCP を介してこのリポジトリのドキュメントを直接読み取れます。

• ドキュメント MCP URL：https://gitmcp.io/theluckystrike/mcp-checklist