loan-schedule

mcp-amortization

位于官方 MCP Registry（io.github.theluckystrike/amortization）。 为 AI 助手提供贷款和租赁还款计划。提供信贷协议条款、金额、以基点表示的名义年利率、计息频率、还款到期频率、期数、计算方法、任何安排费和任何尾款，即可计算还款额、实际年利率，以及逐期还款计划：期初余额、还款额、利息、本金、期末余额。它还能回答提前结清的成本和节省金额，并按照现金簿使用的账户名称，返回一笔还款的复式分录。所有金额均以整数小额货币单位表示，每期的期末余额都会准确达到尾款金额或零。不会向任何地方发送数据：登记簿是你机器上的一个文件。

@theluckystrike/mcp-amortization 尚待发布到 npm，因此目前运行 npx -y @theluckystrike/mcp-amortization 会返回 404。在此之前，可用的方式是一键安装 .mcpb 包，或克隆并构建。

安装

Claude Desktop，macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 上为 %APPDATA%\Claude\claude_desktop_config.json：

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

claude mcp add amortization -- npx -y @theluckystrike/mcp-amortization

Cursor，使用 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目）。配置项与 Claude Desktop 相同。

工具

工具	功能
loan_create	根据条款记录贷款或租赁。返回 LOAN-YYYY-NNNN、固定还款额、实际年利率和总利息
loan_schedule	还款计划：每期的期初余额、还款额、利息、本金、期末余额，以及总利息
loan_repay_early	计算在某一期结清或超额还款的成本：未偿余额、罚金、重新计算后的剩余还款计划，以及扣除罚金前后的利息节省额
loan_journal	按期或按月生成复式分录：借记利息费用和贷款负债，贷记现金，并提供可直接用于 expense_add 的数据
loan_list	登记簿，显示任意日期的未偿余额和下一笔还款日期
loan_delete	删除一份协议并释放其名额。如果已根据该协议生成过分录，则会拒绝删除并指出对应条目
loans_report	按币种列出欠款金额、每笔还款的到期时间，以及日历年度内产生的利息
license_status, license_activate	查看你的方案等级并激活 Pro 密钥

免费版与 Pro

	免费版	Pro
登记簿中的贷款	3	无限
还款计划	无限	无限
删除协议（loan_delete）	是	是
提前还款（loan_repay_early）	-	是
分录（loan_journal）	-	是
报告（loans_report）	-	是

loan_delete 特意设为免费功能。限制针对的是登记簿中保存的协议数量，否则，同一份租赁协议记录两次就会占用三个名额中的两个，且除了使用密钥外别无释放名额的办法；loan_create 会在写入任何内容之前拒绝重复记录，并指出匹配的条目，而登记簿中已有的记录都可以通过 loan_delete 删除。如果某笔贷款已生成过分录，则会拒绝删除并指出对应条目，因为这些分录已经进入某人的账簿。

还款计划永远不会限量。计算还款额和利息正是此服务存在的目的，而隐藏答案的免费版就只是个演示。限制针对的是保存的协议数量，因为这才是工作量的计量单位。

获取 Pro：https://mcp.zovo.one/buy/amortization，此服务单独购买一次性收费 $19，或以 $39 购买捆绑包。

一项经过测算的发现

按季度报出的利率若以名义利率除以 4，贷方可多获得相当于利息总额 1.0％ 的收益。 以名义年利率 12％、按月复利、分 4 期按季度还款的 10,000 欧元贷款为例。一个季度的等效利率为 (1 + 0.12/12)^3 - 1 = 3.0301％，而不是 0.12/4 = 3.0000％。这 3 个基点的差异会让每期还款额变为 2,692.21 欧元，而非 2,690.27 欧元；总利息变为 768.84 欧元，而非 761.08 欧元：一笔为期一年的 10,000 欧元贷款，贷方将多收 7.76 欧元，相当于利息总额的 1.0％。 报价中的两个利率看起来相同，但在还款计划中却会产生差异，因此此服务会将每个等效利率都按复利周期计算，并将所用的周期利率精确打印到小数点后 6 位。

同样的计算也说明了为什么每笔贷款都会在名义利率旁报告有效年利率：按月复利的名义年利率 12％，其有效年利率为 12.68％；这 0.68 个百分点，正是标示利率未体现的成本部分。

隐私

所有数据都保存在本地，路径为 ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/amortization/。共有两个文件：loans.json 和 counter.json。此服务的任何工具都不会进行网络调用。不会存储还款计划中的任何一行：每一行都根据调用时提供的条款计算得出，因为存储还款计划就等于保存一份额外的副本，而这些数字本来已由利率和期限决定；一旦有人修改利率，人们往往会相信的却是这份副本。

由 theluckystrike 构建。https://github.com/theluckystrike

将这些文档用作 MCP 服务

任何 MCP 客户端（Claude、Cursor、Windsurf、VS Code）都可以通过 GitMCP 直接读取此代码库的文档，无需安装：

• 文档 MCP URL：https://gitmcp.io/theluckystrike/mcp-amortization