delivery-schedule-milestones-late-report

mcp-delivery-schedule

公式 MCP Registry（io.github.theluckystrike/delivery-schedule）に掲載されています。 見積もり、作業指示書、または変更指示書に対する日付付きの成果物を管理します。各成果物には、引き渡す内容、期限日、最小通貨単位での金額、そして予定から進行中、納品済み、承認済みへと移るステータスが記録され、各ステップで実際にその状態になった日付も残ります。late_report では、スケジュールについて誰もが知りたい唯一のこと、つまり指定した日付時点で遅れているものは何かがわかります。クライアントが何かを承認すると、承認済みのマイルストーンが、MAJOR 単位の invoice_create 対応項目と、MINOR 単位の quote_create 対応項目として、各項目に単位を明記したうえで、1 回の呼び出しで返されます。

ここでは、遅延はステータスではなく、その時点での状況です。「遅延」というフラグを保存すると、レポートを最後に実行した日の午後の事実が記録され、作業が完了した後もずっと遅延として報告され続けます。そのため、算出値は何も保存されません。成果物には期限日、金額、日付付きの履歴のみが保持され、現在のステータス、納品日、承認メモ、遅延状況、すべての合計は、指定した日付に基づいて呼び出し時に算出されます。

インストール

ワンクリック（.mcpb）：最新リリースから delivery-schedule.mcpb をダウンロードし、Claude Desktop でダブルクリックしてください： https://github.com/theluckystrike/mcp-servers/releases/latest

ホスト型、インストール不要：URL ベースのクライアントで https://mcp.zovo.one/mcp/delivery-schedule を指定してください。GET https://mcp.zovo.one/mcp/connect を実行すると、トークンが発行され、すぐに使える URL が表示されます。

@theluckystrike/mcp-delivery-schedule の npm 公開は保留中のため、以下の npx の行は現在 404 を返します。

Claude Desktop

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

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

Claude Code

claude mcp add delivery-schedule -- npx -y @theluckystrike/mcp-delivery-schedule

Cursor

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

ツール

ツール	機能
delivery_schedule_create	見積もり、作業指示書、または変更指示書に対するスケジュールを作成します：参照情報、その日付、クライアント、タイトル
deliverable_add	日付付きの成果物を追加します：内容、期限日、個別に価格設定されている場合は最小通貨単位での金額
deliverable_status	日付付きのステータス変更を記録します：進行中、納品済み、クライアントの承認メモ付きの承認済み
deliverable_delete	誤って追加した成果物を、まだ予定のままで、関連する記録がない場合に削除します
delivery_schedule_get	指定した日付時点でのスケジュール全体を取得します。各成果物のステータス、日付、金額、遅延状況を含みます
delivery_schedule_list	クライアント、参照情報、案件の完了状況でスケジュールを一覧表示し、指定した日付時点での件数も表示します
delivery_schedule_delete	誤って作成した空のスケジュールを削除します。すべてのプランで無料です
late_report	指定した日付時点で遅れているものを、遅延の大きい順に、通貨ごとのリスク金額とともに表示します
delivery_schedule_document	クライアント向けのプレーンテキスト形式のスケジュール文書を作成します。承認欄付きです
milestone_payload	承認済みマイルストーンを、invoice_create 項目（MAJOR 単位）と quote_create 項目（MINOR 単位）として返します
license_status / license_activate	Free または Pro のライセンス状態と、アップグレード方法を表示します

Free と Pro

	Free	Pro
オープンなスケジュール（未承認の項目が残っているジョブ）	3	無制限
スケジュールあたりの納品物	200	200
オープン、追加、移動、取得、一覧表示、削除	はい	はい
任意の日付時点での遅延状況	はい	はい
納品スケジュール文書	いいえ	はい
マイルストーン請求書ペイロード（両方の規模）	いいえ	はい

上限の対象は、まだ何かの納品が残っているオープンなスケジュールであり、これまでに実行したことのあるジョブではありません。最後の納品物を承認するとスケジュールは完了し、記録を削除することなく枠が空きます。また、空になったスケジュールは delivery_schedule_delete で削除できます。どちらもすべてのプランで無料です。Pro キーでしか戻れない方法は、戻る方法とは言えないからです。

Pro を入手：https://mcp.zovo.one/buy/delivery-schedule（買い切り $19、永久利用可能）、または全サーバーを $39 で：https://mcp.zovo.one/buy/bundle

ステータスの状態遷移

planned から in_progress、またはそのまま delivered へ進み、delivered から accepted へ進みます。承認は最終状態であり、そこから先に戻ることはありません。クライアントから差し戻された作業は、独自の期限を持つ新しい納品物です。そのため、記録には不履行と修正の両方が残ります。納品されていないものの承認は、対象を明示して拒否されます。承認とはクライアントが引き渡しに対して行う返答であり、何も引き渡されていない日に承認された納品物には、請求の起点となる納品日が存在しないからです。すべての状態遷移には実際に発生した日付が付与されます。また、参照文書の日付より前、または直前の状態遷移より前の日付を指定した状態遷移は拒否されるため、履歴は時系列として保たれます。

「遅延」の意味

納品物は、as_of が期限を過ぎており、その時点までに納品されていない場合に遅延となります。as_of 当日が期限のものは遅延ではなく due_today です。これは、請求書の経過日数を計算するステートメントサーバーと同じルールです。納品済みの納品物は、納品日と期限を比較し、delivered_late または delivered_on_time となります。これは変わることのない事実です。比較はすべて2つの YYYY-MM-DD 文字列間で行われ、日数はすべて2つの UTC の午前0時の差分で算出されるため、ワルシャワのノートパソコンでもオークランドのサーバーでも結果は同じです。

同じストアを4日違いで確認すると、意図どおり異なる結果になります。

late_report as_of 2026-04-22   D02 is LATE by 2 days, nothing has been delivered late
late_report as_of 2026-05-05   D02 was DELIVERED LATE by 4 days, D03 is now LATE by 4 days

価格のない納品物

value_minor のない納品物は、価値がゼロという意味ではありません。ここで価格が指定されていないという意味で、通常はジョブが一括料金だからです。これをゼロとして加算すると、そのことを示す記載がないまま、すべての合計額が過少になります。合計額を表示する箇所では別枠で集計され、milestone_payload では請求対象にせず、excluded.accepted_but_unpriced に記載されます。ここで価格を作り出すことはありません。

金額の計算元

このサーバーは独自の計算処理を保持していません。computeTotals、currencyDecimals、formatMoney、daysBetween は @theluckystrike/mcp-invoice/lib から、破損したストアの隔離処理は @theluckystrike/mcp-timezone/lib から、タイムゾーンを考慮した「今日」の日付は @theluckystrike/mcp-quotes/lib からインポートします。VAT 率、通貨、事業者名は、invoice サーバーの business_set が書き込む共有ビジネスプロファイルから取得します。このサーバー自身のディレクトリ以外には何も書き込まず、兄弟ストアを開くこともありません。

検証された洞察

同じ納品物でも、確認する日付によって遅延、期限内、または期限前となります。したがって、結果を保存することは、誰かが確認した日付を保存することです。 実例の D02 は期限が 2026-04-20 で、2026-04-24 に納品されました。2026-04-22 時点で確認すると、ストアには 04-24 の納品日がすでに記録されているにもかかわらず、納品日がまったくない状態で2日遅れと表示されます。2026-05-01 時点で確認すると、4日遅れで納品済みとなります。2026-04-19 時点で確認すると、まだ期限前です。ストアは1つ、結果は3通り、すべて正解です。ユニットテストスイートでは、変更のない1つのサンドボックスからこの3つすべてを検証します。また、別のテストスイートでは、14時間の時差がある4つのタイムゾーンですべての呼び出しを再実行し、応答のバイト列が完全に一致することを検証します。これにより、移動中に持ち運んだノートパソコンでレポートを確認した日によって、クライアントの期限が変わることはありません。

プライバシー

すべてのデータは、マシン上の ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/delivery-schedule/ に保存されます。データが外部に送信されることはありません。アカウントも API キーも不要です。ライセンスキーはオフラインで検証されます。このサーバーが読み取る、自身が所有していないファイルは共有ビジネスプロフィールのみで、書き込み先は自身のストアだけです。

theluckystrike が開発しました。https://github.com/theluckystrike

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

あらゆる MCP クライアント（Claude、Cursor、Windsurf、VS Code）から、インストール不要で GitMCP 経由でこのリポジトリのドキュメントを直接読み取れます。

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