ledger

@eternal-roman/ledger-mcp

@eternal-roman/ledger 用の MCP アダプターです。カーネルが計算を行い、このプロセスは stdio 経由で公開します。

エージェントはトークン内で金額を計算してはいけません。代わりに、これらのツールを呼び出してください。

実行

npx -y @eternal-roman/ledger-mcp

{
  "mcpServers": {
    "ledger": {
      "command": "npx",
      "args": ["-y", "@eternal-roman/ledger-mcp"]
    }
  }
}

Cursor、Windsurf、その他の stdio MCP ホストでも同じ形式で使用できます。

起動時に ledger://canon/rules、続いて ledger://canon/workflow を読み込んでください。カタログ：ledger://tools/catalog。

ツール

ツール	使用するタイミング
money_compute	あらゆる算術演算（加算／減算／乗算／除算／配分／換算／比較）
entry_validate	記帳前
ledger_post	検証してから適用します。フェイルクローズです
ledger_balance	1つの勘定科目（通貨が混在する場合は currency を渡します）
ledger_trial_balance	すべての勘定科目
ledger_verify_equation	資産 + 費用 = 負債 + 資本 + 収益
ledger_audit_hash	改ざん検知可能なダイジェスト（ledger-audit-v2）
ledger_verify_determinism	2回再構築し、バイト単位で一致することを確認します
trace_run	ステップごとのチェックポイント付きで再生します
cite_lookup	グラフから IFRS／GAAP を検索します
artifact_make	証明バンドルを作成します。ハッシュはセッションで発行されたものか、再計算可能なものである必要があります
periods_create_lock	ハードクローズロックを作成します
periods_guarded_post	記帳します。期間がロックされている場合は拒否されます
closing_generate_entries	収益／費用 → RE
fx_compute_translation	報告通貨 + CTA
depreciation_build_schedule	定額法または定率法
cashflow_statement	現金勘定から直接法で作成します
reconcile_positions	台帳と外部スナップショットを照合します
portfolio_relief	FIFO／LIFO／HIFO ロット
settlement_build_entries	取引日と T+N

ステートレスです。台帳の JSON を入力し、台帳の JSON を出力します。プロンプト：post_entry、audit_ledger、cite_treatment。

アドバイスではありません

決定論的なツールのみです。入力、管轄区域、コンプライアンスについては、ご自身の責任で対応してください。MIT LICENSE。