Ledger

io.github.eternal-roman由 GitHub 帳號 eternal-roman 發布v0.19.1更新於 Oct 25, 2026

Exact-decimal double-entry for agents. Call MCP tools; do not do money math in tokens.

已驗證STDIO僅桌面金融開發者工具

概覽

AI 產生的概覽

一個本機 stdio MCP 伺服器，為助理提供精確十進位的複式記帳工具，讓金額運算與記帳在程式碼中完成，而不是在 token 中計算。

可以做什麼
進行精確十進位金額運算：加、減、乘、除、分攤、換算與比較，並從圖譜查詢 IFRS/GAAP 依據。驗證並過帳會計分錄，包括對已鎖定會計期間的受保護過帳，以及建立硬結帳期間鎖。讀取單一科目餘額或全部科目的試算表，驗證會計恆等式，並產生結轉分錄與現金流量表。產生稽核雜湊、驗證決定性、帶檢查點重播執行並建立證明包。處理含 CTA 的外幣換算、折舊排程、部位對帳、FIFO/LIFO/HIFO 批次處分以及交易日與 T+N 結算分錄。
適用情境
當助理需要做記帳或財務運算，且不能容忍捨入誤差與以 token 為基礎的數學計算時使用，例如過帳分錄、核對餘額、結帳期間或稽核帳本。它適合具決定性、可重現的會計工作流程，而非一般性財務建議。
執行需求
以本機程序透過 stdio 執行，使用 npx 從 npm 套件啟動，因此需要 Node.js 以及下載套件的網路存取。未宣告驗證、環境變數或標頭。帳本資料以 JSON 形式傳入與傳出。
安裝前請注意
它會過帳與鎖定會計分錄並建立期間鎖，會改變帳本狀態，套用前應檢查輸入。它只是決定性工具，不提供財務、稅務或法規遵循建議；輸入、司法管轄區與法規遵循由你負責。證明包需要由工作階段簽發或可重新計算的雜湊。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Ledger，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@eternal-roman/ledger-mcp

MCP adapter for @eternal-roman/ledger. The kernel does the math. This process exposes it over stdio.

Agents must not compute money in tokens. Call these tools instead.

Run

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

Same shape in Cursor, Windsurf, and other stdio MCP hosts.

On start, read ledger://canon/rules, then ledger://canon/workflow. Catalog: ledger://tools/catalog.

Tools

ToolUse when
money_computeAny arithmetic (add/sub/mul/div/allocate/convert/compare)
entry_validateBefore posting
ledger_postValidate then apply; fail-closed
ledger_balanceOne account (pass currency if mixed)
ledger_trial_balanceEvery account
ledger_verify_equationAssets + Expenses = Liabilities + Equity + Income
ledger_audit_hashTamper-evident digest (ledger-audit-v2)
ledger_verify_determinismRebuild twice; byte-identical
trace_runReplay with per-step checkpoints
cite_lookupIFRS/GAAP from the graph
artifact_makeProof bundle; hash must be session-issued or recomputable
periods_create_lockCreate a hard-close lock
periods_guarded_postPost, rejected if the period is locked
closing_generate_entriesIncome/Expense → RE
fx_compute_translationReporting currency + CTA
depreciation_build_scheduleStraight-line or declining
cashflow_statementDirect method from cash accounts
reconcile_positionsLedger vs external snapshot
portfolio_reliefFIFO/LIFO/HIFO lots
settlement_build_entriesTrade date vs T+N

Stateless: ledger JSON in, ledger JSON out. Prompts: post_entry, audit_ledger, cite_treatment.

Not advice

Deterministic tools only. You own inputs, jurisdiction, and compliance. MIT LICENSE.

來源：mcp/README.md，提交 c839c8f

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.19.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分