ledger

Name: ledger
Author: eternal-roman

本地服务

github.com/eternal-roman金融数据14 周前更新

代码仓库

关于 ledger

ledger 是 `@eternal-roman/ledger` 的 MCP 适配器，通过确定性工具处理精确十进制复式记账，面向需要可靠财务计算和审计流程的 Agent。它以 stdio 暴露工具，并提供账务校验、结账及报告功能。

主要功能

01精确十进制计算
02分录验证与过账
03账户及试算平衡
04审计哈希与确定性验证
05结账、折旧与现金流工具
06外部头寸对账

适用场景

01计算并校验财务分录
02核对账户余额和会计恒等式
03生成结账、折旧或现金流数据
04对比账簿与外部头寸快照

MCP 相关

作为 stdio MCP 适配器，将 `@eternal-roman/ledger` 的工具、资源和提示词提供给 MCP 主机。启动后可读取账务规则、工作流和工具目录资源。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令npx -y @eternal-roman/ledger-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@eternal-roman/ledger-mcp0.19.1stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
a	object	是
a.amount	string	是	精确的十进制字符串，绝不能是浮点数字面量
a.currency	string	是
b	any	否	用于 add/sub/compare 的第二个操作数
op	enum	是	add \| sub \| mul \| div \| allocate \| convert \| compare \| negate \| abs
rate	object	否	用于 convert 的外汇汇率
rate.to	string	是
rate.from	string	是
rate.rate	string	是
ratios	array	否	用于 allocate 的比例
scalar	string	否	用于 mul/div 的标量，格式为十进制字符串
roundingMode	enum	否	用于 mul/div/convert 的舍入模式HALF_UP

详细介绍

@eternal-roman/ledger-mcp

@eternal-roman/ledger 的 MCP 适配器。内核负责计算。此进程通过 stdio 提供服务。

Agent 不得用 token 计算金额。请改用这些工具。

运行

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`	单个账户（混合币种时传入 `currency`）
`ledger_trial_balance`	所有账户
`ledger_verify_equation`	资产 + 费用 = 负债 + 权益 + 收入
`ledger_audit_hash`	可检测篡改的摘要（`ledger-audit-v2`）
`ledger_verify_determinism`	重建两次；结果逐字节相同
`trace_run`	使用逐步检查点重放
`cite_lookup`	从图谱中查询 IFRS/GAAP
`artifact_make`	证明包；哈希必须由会话签发或可重新计算
`periods_create_lock`	创建硬结账锁定
`periods_guarded_post`	过账；若期间已锁定则拒绝
`closing_generate_entries`	收入／费用 → 留存收益
`fx_compute_translation`	报告币种 + CTA
`depreciation_build_schedule`	直线法或递减法
`cashflow_statement`	根据现金账户采用直接法编制
`reconcile_positions`	将分类账与外部快照核对
`portfolio_relief`	FIFO/LIFO/HIFO 批次
`settlement_build_entries`	交易日与 T+N