ledger

mcp-cash-book

公式 MCP Registry（io.github.theluckystrike/cash-book）に掲載されています。 すでに使用している帳簿をまとめた、1つの複式簿記元帳です。請求書、クレジットノート、発注書、預り金、経費、銀行取引明細のインポートデータ、固定資産台帳を読み取り、期間内のすべての取引について借方と貸方を導き出します。請求書から売上と仮受消費税、売掛金とそれを消し込む入金、負債として扱われる預り金、総額から消費税を差し引いたカテゴリー別経費、固定資産と月次減価償却を計上します。試算表の合計が最小通貨単位までゼロになることを証明し、ゼロにならない場合は、数値の合計が一致しない書類を特定します。これらの帳簿には一切書き戻さず、元帳に仕訳を入力する方法もありません。すべての明細に、取得元のサーバー、書類 ID、日付が記録されるため、どの数値も印刷されたページまでたどれます。

@theluckystrike/mcp-cash-book の npm 公開は保留中のため、現時点では npx -y @theluckystrike/mcp-cash-book は 404 を返します。それまでは、.mcpb ワンクリックバンドル、または clone+build をご利用ください。

インストール

Claude Desktop の場合、~/Library/Application Support/Claude/claude_desktop_config.json（Windows：%APPDATA%\Claude\claude_desktop_config.json）：

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

Claude Code：

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

Cursor の場合：~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）。Claude Desktop と同じエントリーを使用します。

このサーバーは、帳簿を管理する以下のサーバーと併用する場合にのみ役立ちます：mcp-invoice、mcp-billing-docs、mcp-deposits、mcp-expense-tracker、mcp-bank-statement、mcp-asset-register。いずれも必須ではありません。インストールされていないストアは元帳に表示されません。インストール済みでも読み取れないストアは読み取り不能として報告され、空のストアとして扱われることはありません。

ツール

ツール	機能
ledger_build	1つの通貨で1期間分の元帳を導き出し、その期間を登録します
period_delete	登録から作成済み期間を1つ削除し、無料プランの枠を戻します
trial_balance	借方と貸方を合計し、最小通貨単位まで一致することを証明します
ledger_lines	勘定科目、取得元サーバー、取得元書類、または日付で絞り込んで明細を一覧表示します
month_close	未転記または不整合の項目を一覧表示してから、スナップショットを作成して月を締めます
ledger_export_csv	RFC 4180 CSV 形式で、各仕訳行を1行として明細を返します
ledger_report	勘定科目ごとの増減と残高を、仕入コミットメントおよび例外とともに表示します
license_status	Free または Pro の状態と、アップグレード方法を表示します
license_activate	Pro キーをオフラインで検証して有効化します

勘定科目：cash、receivables、revenue、vat_output、vat_input、expenses:<category>、deposits_held、fixed_assets、accumulated_depreciation、depreciation_expense、および決して転記されないメモとしての purchase_commitments。

Free と Pro の比較

	Free	Pro
trial_balance	無制限	無制限
ledger_lines	無制限	無制限
ledger_build	1暦月あたり3期間	無制限
作成済みの期間の再構築	無料	無料
変更のない期間の再構築	拒否され、行名が示されます	拒否され、行名が示されます
period_delete	無制限	無制限
month_close	-	はい
ledger_export_csv	-	はい
ledger_report	-	はい

試算表が無料なのは、このサーバーが答えるために存在する唯一の質問だからです。帳簿が一致しているか確認できない簿記担当者には、ここにあるほかの情報を信頼する理由がありません。

ledger_lines は bank_ref を含め、ledger_export_csv が返すすべてのフィールドをすでに返します。エクスポートは書式を整えるための便宜的な機能であり、同じフィールドを列にした RFC 4180 形式のファイルであって、新しいデータではありません。Round 29（data/user_value_r29.json、プロンプト 6）では、モデルが ledger_export_csv に対する Pro の拒否を正しく受け止めた後、ledger_lines から代替の CSV を手作業で作成し、それでも bank_ref を落としてしまうことが確認されました。現在のゲートテキストではこの点を明記しているため、クライアントは CSV を再構成せずに ledger_lines を中継します。

Pro を入手：https://mcp.zovo.one/buy/cash-book （買い切り、永久利用、オフライン認証）。

測定で得られた知見

test/_client.mjs の対象月では、銀行明細の5行のうち4行が、すでに計上済みの書類と同じ資金の動きを示しています。現金の動きにあたる1,380,300最小通貨単位のうち1,375,300、つまり99.6パーセントが両方の帳簿に記載されています。現金出納帳を作る際に誰もが思いつく方法であり、ほとんどのスプレッドシートが採用している方法ですが、銀行明細のインポート分も書類分も計上すると、現金残高は -10,543.00 EUR から -21,111.00 EUR になります。間違いには見えません。各行は個別に見ればもっともらしく、口座残高はほぼ正確に2倍ずれていますが、試算表の合計は依然としてゼロです。重複した入金それぞれに、相手勘定も付いているためです。

そのため、ここでは銀行明細のインポート分を計上しません。計上済みの現金の動きと照合し、残った項目こそが重要です。この月の場合、銀行明細の合計のうち7,500最小通貨単位、つまり説明のつかない引き出し1件が、書類にはすでに記録されていなかった情報です。これこそが、明細をインポートする価値のある0.4パーセントであり、重複の多い帳簿では埋もれてしまう部分です。

プライバシー

すべてのデータはお使いのマシン上に保持されます。帳簿は呼び出しのたびに、兄弟サーバーがそれぞれ独自のデータディレクトリ ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/ に保存しているデータから生成されます。このサーバーが書き込むのは、独自の cash-book/periods.json と cash-book/closes.json のみです。src 内にネットワーク呼び出しはなく、テレメトリーもありません。ライセンスキーはオフラインで認証されます。

theluckystrike によって開発されました。https://github.com/theluckystrike

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

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

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