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 分