retainer

mcp-deposits

クライアントごとに管理する保証金と着手金を、請求書と同じエンジンで扱います。

保証金は、クライアントのお金をあなたのアカウントで預かっているものです。入金時に記録し、作業の請求時に請求書に充当し、充当されない場合は返金し、その間いつでも「預かっている相手のお金はいくらか、通貨は何か、いつから預かっているか」に答えられるようにする必要があります。このサーバーは、mcp-invoice サーバーがすでに管理している請求書とクライアントを使って、この4つの処理を行います。保証金を請求書に充当すると、その支払いは請求書に記録されるため、invoice_list と overdue_report は、すでに預かっているお金を未払いとして追い続けることがなくなります。すべてのデータはお使いのマシン上に保持されます。

金額、通貨、ストアのコードには @theluckystrike/mcp-invoice/lib を、A4 ページには @theluckystrike/mcp-billing-docs/lib を使用しています。そのため、保証金明細書は隣にあるクレジットノートや請求書と同じ見た目になり、最小通貨単位まで一致します。

公式 MCP Registry に掲載されています（io.github.theluckystrike/deposits）。

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

インストール

Claude Desktop（claude_desktop_config.json）：

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

Claude Code：

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

Cursor（.cursor/mcp.json）：

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

mcp-invoice と一緒に実行してください。このサーバーは mcp-invoice サーバーの請求書とクライアントを読み取り、充当した保証金による支払いを請求書に記録します。また、両サーバーは共通の事業者プロフィールから、事業者名、住所、VAT ID、デフォルト通貨を取得します。

ツール

ツール	機能
deposit_record	受け取った保証金または着手金を記録します。最小通貨単位での金額、通貨、日付、参照情報を指定します
deposit_list	受領額、充当額、返金額、預かり額を含むすべての保証金を表示します。クライアント、ステータス、種類、日付で絞り込めます
deposit_apply	預かり中の保証金の一部または全額を請求書に充当し、その請求書の支払いとして記録します
deposit_refund	日付と方法を指定して、預かり中の保証金の一部または全額を返金します
deposit_delete	誤って記録した保証金を削除します。ただし、一部でも充当または返金済みの場合は削除できません
deposit_balance	クライアント別、通貨別の預かり額を表示します。受領額、充当額、返金額、預かり額を確認できます
deposit_statement_text	メールに貼り付けられるプレーンテキストの明細書を作成します
deposit_statement_pdf	DEPOSIT STATEMENT（Pro）というタイトルの A4 PDF を作成します
deposits_report	通貨別の預かり額、最も古い預かり中の保証金、N 日間未充当のままの金額を表示します（Pro）
license_status, license_activate	Free または Pro の状態と、アップグレード方法を確認します

リソースは deposits://held の1つ、プロンプトは settle_deposits の1つです。

Free と Pro

	Free	Pro
1暦月あたりに記録できる入金数	5	無制限
請求書、返金、残高、一覧への適用	はい、無制限	はい
資金が一度も移動していない入金に対する deposit_delete	はい、無制限	はい
deposit_statement_text	はい、無制限	はい
deposit_statement_pdf	いいえ	はい。ロゴを追加でき、フッターのクレジットもありません
deposits_report	いいえ	はい

無料枠の上限は、新しい入金の記録にのみ適用されます。すでに預かっている資金は、どのプランでもいつでも適用、返金、計上できます。クライアントの入金を動かせなくする上限は、あなたではなくクライアントの資金を制限することになります。

上限の対象となるのは、その月の日付を受領日として保存された入金です。そのため、deposit_delete を使えば枠がすぐに戻ります。入金を二重に入力したり、金額を間違えたりしても、ID以外のコストはかかりません。また、deposit_record は、クライアント、金額、通貨、種類、受領日、参照情報がすべて一致する入金がすでに保存されている場合、その入金の記録を拒否してIDを提示し、何も保存しません。そのため、同じ資金を二重に預かることはなく、再試行で無料枠が消費されることもありません。

Pro を購入：https://mcp.zovo.one/buy/deposits（このサーバー単体で一度限りの支払い $19、バンドルは $39）。

実測例

請求書サーバー独自の支払いツールは、支払済み金額を設定するため、入金をこのツール経由で処理すると、それ以前の支払いが消去されます。 EUR 1,000.00 の請求書に対して servers/invoice/dist/index.js で実測したところ、銀行振込に invoice_mark_paid {amount: 200} を実行し、続いて入金に invoice_mark_paid {amount: 300} を実行すると、paid_minor は 30000 となり、応答には「残高 EUR 700.00」と表示されます。実際に受け取った EUR 200.00 は記録から消え、クライアントにはその分の支払いを催促することになります。

deposit_apply は同じレコードの同じ3つのフィールド、paid_minor、paid_date、status に書き込みますが、値を加算します。同じ2件の支払いを適用すると、paid_minor は 50000 となり、残高は EUR 500.00 になります。これは test/unit.test.mjs の「2回目の適用では paid_minor に加算し、置き換えない」というテストで検証されています。

一般化すると、2つのサーバーが共有するストアに安全に書き込めるのは、それを所有するサーバーがどのように書き込むかを確認した場合に限られます。フィールド名が一致することは契約ではありません。重要なのは、フィールドに対する計算処理です。

プライバシー

すべてのデータはローカルに保存されます：${XDG_DATA_HOME:-~/.local/share}/mcp-servers/deposits/。アカウントもAPIキーもネットワーク通信も一切ありません。ライセンスキーはオフラインで検証されます。

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

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

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

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