work-order

mcp-work-order

公式 MCP Registry に掲載されています（io.github.theluckystrike/work-order）。 現場作業や職人仕事の作業指示書を、作業カードと同じ形式で管理します。クライアント（請求書で使用するものと同じクライアントレコード）に対して作業指示書を発行し、現場住所、依頼日、作業内容、緊急度を指定します。作業の進行に合わせて、実際に使用したものを記録します。労務は単価を設定した時間として、部品は数量と単価、および任意のマークアップとして記録します。下書きから予定済み、作業中、完了、請求済みへと、各ステップで日付とメモを記録しながら順に進めます。完了したら、作業時間、材料、合計金額、署名欄を記載した完了報告書を顧客に渡し、請求書の内容を数字を一つも再入力することなく、そのまま invoice_create に渡せます。

値、作業時間、材料、VAT はすべての呼び出しで明細から算出されるため、何も捏造されず、二重に保存されることもありません。請求書ペイロードの単価はすでに請求対象の単価になっているため、請求書は作業指示書を最小通貨単位まで正確に再現します。

@theluckystrike/mcp-work-order の npm 公開は保留中のため、現時点では npx -y @theluckystrike/mcp-work-order は 404 を返します。それまでは、.mcpb ワンクリックバンドル、またはクローンしてビルドする方法をご利用ください。

インストール

Claude Desktop

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

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

Claude Code

claude mcp add work-order -- npx -y @theluckystrike/mcp-work-order

Cursor

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

ツール

ツール	説明
work_order_create	作業指示書を発行し、WO-YYYY-NNNN 形式の番号を返します。クライアント、現場住所、依頼日、説明、優先度を指定します
work_order_add_line	明細を1行追加します。数量と最小通貨単位の単価、および任意のマークアップ率を指定した部品、または時間と時給を指定した労務を追加できます
work_order_status	下書き、予定済み、作業中、完了、請求済みの順にステータスを1段階進め、日付とメモを記録します
work_order_get	作業指示書1件の全情報を取得します。請求単価付きの全明細、作業時間、材料、税抜額とVAT、ステータス履歴を確認できます
work_order_list	ステータス、クライアント、依頼日の期間で作業指示書を一覧表示します
work_order_delete	誤って発行した作業指示書を削除します。明細のない下書きのみ対象です。すべてのプランで無料です
completion_report_text	メールにそのまま貼り付けられる、プレーンテキスト形式の完了報告書を作成します
completion_report_pdf	署名欄付きのA4 PDF形式の完了報告書を作成します
work_order_invoice_payload	明細と共通プロフィールの税率を使って、invoice_create にそのまま渡せるペイロードを作成します
work_orders_report	全体の状況を表示します。ステータス別の作業指示書数、今月記録された作業時間、通貨別の未請求額を確認できます
license_status / license_activate	Free または Pro のライセンス状況と、アップグレード方法を確認します

Free と Pro の比較

	Free	Pro
未完了の作業指示書	5	無制限
作業指示書あたりの明細	200	200
発行、記録、ステータス変更、一覧表示、削除	はい	はい
完了報告書（テキスト）	はい	はい
完了報告書（PDF）	いいえ	はい
請求書ペイロード	いいえ	はい
作業状況レポート	いいえ	はい

上限の対象は未完了の作業指示書（下書き、予定済み、作業中）であり、これまでに発行した総数ではありません。そのため、作業を完了すると枠が空きます。明細のない下書きに対する work_order_delete でも枠が空きます。この操作はすべてのプランで無料です。Pro キーでしか使えない復帰手段は、復帰手段とは言えません。

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

金額の計算元

このサーバーは独自の計算処理を持ちません。computeTotals、currencyDecimals、 formatMoney、roundHalfUp は @theluckystrike/mcp-invoice/lib から、A4 レンダラーは @theluckystrike/mcp-billing-docs/lib から、破損したストアの隔離処理は @theluckystrike/mcp-timezone/lib からインポートされます。VAT 税率、通貨、事業者名は、 請求書サーバーの business_set が書き込む共有事業者プロファイルから取得します。 クライアント情報は、そのサーバーのクライアント記録から取得します。このサーバーの ディレクトリ外には何も書き込みません。

実測でわかったこと

上乗せ率を適用するのは行の合計ではなく単価であり、それを示すのは最小通貨単位の差です。 EUR 12.99 に 15 パーセントを上乗せした 7 個分の単価は EUR 14.94、行の合計は EUR 104.58 です。 行の合計に上乗せすると、round(9093 * 1.15) = 10,457 最小通貨単位となり、 1 セント少なくなります。どちらも同じ合計に見えますが、実際に顧客への請求額となるのは 片方だけです。請求書サーバーはまず単価を最小通貨単位に丸めてから乗算するため （D-R24 の計算基準）、行の合計額を見積もる作業指示書では、請求書で再現できない金額を 提示することになります。この差は、上乗せ後の単価がセント単位の整数にならないすべての行で 発生します。これは誤差ではなく丸めの方向によるものなので、複数行を合算しても相殺されず、 どちらの計算基準でも正しく合計されるため、スプレッドシートでの確認では見えません。 ユニットテストスイートでは 1 単位の差を明示的に検証しているため、計算基準を変えると、 案件を一つひとつひそかに再価格設定することなく、ビルドが失敗します。

プライバシー

すべてのデータは、あなたのマシン上の ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/work-order/ に保存されます。 外部にデータが送信されることはありません。アカウントも API キーも不要です。ライセンスキーは オフラインで検証されます。このサーバーが読み込むのは、兄弟ディレクトリにある請求書サーバーの clients.json だけで、データを書き込むのは自身のストアのみです。

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

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

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

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