cash-float

Claude から小口現金の定額資金を管理する

公式 MCP Registry に登録されています（io.github.theluckystrike/petty-cash）。 書類上の手順どおりに管理する小口現金の定額資金です。定額資金額と管理者を指定して金庫を開き、そこから支出するたびに伝票を記録し、いつでも現金を数えて、差額を最小通貨単位まで算出するとともに、その計数の対象となった伝票の一覧を取得できます。金庫の現金が少なくなると、補充に必要な内容を算出します。定額資金を元に戻すための小切手の金額、その小切手で精算する伝票、カテゴリ別の合計をまとめた expense_add 対応のペイロード、さらに現金出納帳固有の勘定科目名を使った複式仕訳が含まれます。金額はすべて最小通貨単位の整数で、残高は一切保存されず、どこにも転記されません。ペイロードは帳簿の管理者に返されます。

theluckystrike が開発しました。

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

インストール

Claude Desktop

macOS の ~/Library/Application Support/Claude/claude_desktop_config.json、Windows の %APPDATA%\Claude\claude_desktop_config.json：

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

Claude Code

claude mcp add petty-cash -- npx -y @theluckystrike/mcp-petty-cash

Cursor

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

ツール

ツール	機能
float_open	インプレスト方式で定額資金を開設します。名称、通貨、最小通貨単位での定額資金額、管理者を指定します。FLOAT-YYYY-NNNN と開設時の仕訳を返します
topup_record	金庫に入れる現金を記録します。金額、日付、入金元を指定します。その日までのすべての伝票を精算済みにします
voucher_add	金庫からの支出伝票を1件記録します。金額、日付、カテゴリ、説明、支払先、領収書の参照情報を指定します。VOU-YYYY-NNNN を返します
voucher_delete	誤って入力した伝票を、まだ計数されていない場合に削除します
reconcile	現金を数えます。想定残高、差額、前回の計数以降の伝票を返し、すべての伝票を照合済みにして、計数結果を記録します
replenish_request	定額資金を元に戻すために必要な内容を返します。金額、対象となる伝票、カテゴリ別の expense_add ペイロード、複式仕訳が含まれます。何も書き込みません
float_report	定額資金額に対する残高、未照合の伝票、前回の計数、計数で見つかった差額のすべての履歴を表示します
license_status / license_activate	Free または Pro の状態とライセンスキーを確認・有効化します

Free と Pro の違い

	Free	Pro
開設できる定額資金	1	無制限
1暦月あたりの伝票数	20	無制限
照合（reconcile）	無制限	無制限
伝票の削除（voucher_delete）	可	可
補充の記録（topup_record）	可	可
補充リクエスト（replenish_request）	-	可
レポート（float_report）	-	可

計数は利用回数に含まれません。金庫の現金と書類が一致するかどうかを確かめることこそ、このサーバーの目的です。その答えを提供しない無料プランでは、デモにしかなりません。利用回数の対象となるのは記録の量です。2つ目の定額資金は2つ目の金庫を意味し、月20件の伝票数は、実際に1つの金庫を運用するオフィスに見合った数です。voucher_delete が無料なのも、保持できる記録数に上限を設けているのと同じ理由です。伝票を二重に入力したとき、ライセンスキーを使わなければ元に戻せないまま枠を消費することがないようにしています。

Pro を入手：https://mcp.zovo.one/buy/petty-cash。このサーバー単体は一回限りの購入で $19、バンドルは $39 です。

測定から得られる知見

小切手の金額は伝票の合計額とは異なり、その差は伝票の記録からは見えません。

test/unit.test.mjs の実例では、EUR 500.00 の定額前渡資金に対し、5 枚の伝票の合計は最小通貨単位で 20,194 です。そのため、帳簿上は31日時点で金庫に29,806あることになります。しかし、実際には29,795です。実査額はちょうど最小通貨単位で11不足しており、伝票では説明できず、領収書も見つかることのない11セントの差です。

その後の補充額は20,194ではなく20,205です。伝票の合計額を払い戻すのが自然ですし、実際に伝票の合計額でもありますが、それでは資金残高は11不足したままです。同じテストスイートでは、このサイクルを3回実行します。最終的な資金残高は、定額前渡資金50,000に対して49,967となり、最小通貨単位で33不足します。その間に行われた3回の照合では、いずれも差額がちょうど11と報告され、それ以上の問題はありません。何も問題が起きているようには見えません。ただ金庫の中身が少しずつ減っていくだけです。

だからこそ、replenish_request は sum(vouchers) ではなく imprest - balance を計算し、差額を費目にまとめて郵送料のように見せるのではなく、独立した cash_over_short の仕訳行として返します。

プライバシー

すべてのデータは ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/petty-cash/ にローカル保存されます。ファイルは floats.json、vouchers.json、counter.json の3つです。データが外部に送信されることはなく、アカウントもAPIキーも必要ありません。このサーバーではネットワーク呼び出しも一切ありません。ライセンスキーはオフラインで検証されます。仕訳と expense_add のペイロードはユーザーに返されます。このサーバーがほかのストアに何かを書き込むことはありません。

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

よくある質問

小口現金用の MCP サーバーはありますか？

はい。mcp.zovo.one の petty-cash サーバーでは、定額資金方式で小口現金を管理できます。伝票、補充、費目別残高、照合に対応しています。無料プランがあり、ホスト型エンドポイントを利用でき、ローカル優先でデータを保存します。

Claude で小口現金を管理するにはどうすればよいですか？

https://mcp.zovo.one/mcp/petty-cash に接続して、「事務用品の伝票を15 EURで記録して」と伝えます。補充と照合は、それぞれ1つのプロンプトで実行できます。

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

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

• Docs MCP URL：https://gitmcp.io/theluckystrike/mcp-petty-cash