The Real Cost

Name: The Real Cost
Author: NoBanks

本地服务

therealcost.nohumannearby.com金融数据04 周前更新

代码仓库访问官网

关于 The Real Cost

The Real Cost 是运行免费美国个人理财计算器并说明公式的 MCP 服务，供 AI 助手生成教育用途的估算。每项结果都附有预填数值的计算器链接和非财务建议免责声明。

主要功能

01计算信用卡还款成本
02比较现有债务与整合贷款
03按期限估算贷款成本
04计算加密货币交易成本
05规划应急基金目标
06返回公式和计算器链接

适用场景

01比较最低还款与固定还款金额
02评估整合贷款与现有债务
03查看不同贷款期限的还款额
04估算应急基金所需储蓄

MCP 相关

向 MCP 客户端提供理财计算工具和指南列表工具。结果包含计算详情、预填数据的网站链接，以及仅供教育用途的免责声明。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "nobanks-therealcost": {
      "command": "uvx",
      "args": [
        "therealcost-mcp"
      ]
    }
  }
}

启动命令uvx therealcost-mcp

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

安装包

pypitherealcost-mcp0.1.0stdio

工具

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

参数	类型	必填	说明
apr	number	是	信用卡 APR 百分比，例如，24 表示 24%。
balance	number	是	当前信用卡余额，单位为美元，例如，5000。
min_pct	number	否	最低还款额占余额的百分比（许多信用卡为 1）。
payment	any	否	用于与仅支付最低还款额进行比较的固定月还款额，例如，200。
min_floor	number	否	账单上列出的最低还款额美元下限。
min_plus_interest	boolean	否	若最低还款额为 min_pct 乘以余额再加上当月利息（常见做法），则为 True；若仅为 min_pct 乘以余额，则为 False。

详细介绍

therealcost-mcp

为 AI Agent 提供免费的财务计算器，来自 The Real Cost。

NoBanks Nearby 推出的 The Real Cost 是一组免费的美国财务计算器，计算过程清晰可见：信用卡还款、债务整合、按期限计算贷款成本、加密货币交易费用和应急基金。这个 MCP 服务让 Claude 和其他 AI 助手可以运行这些完全一致的计算器，并向用户提供网站上对应计算器的链接，且已填入用户的数字，让用户可以核对计算结果并继续调整参数。

网站：https://therealcost.nohumannearby.com
所有计算器：https://therealcost.nohumannearby.com/calculators/
指南：https://therealcost.nohumannearby.com/books/

仅供教育用途，不构成财务建议。 结果是根据输入数字得出的估算值。

每个结果都包含什么

每个计算器工具都会返回包含以下内容的 JSON：

键	含义
`result`	数字结果（月数、总利息、还款额、费用）
`summary`	用一段通俗易懂的话说明结果
`formula`	用文字说明公式，让用户了解数字的计算方式
`calculator_url`	therealcost.nohumannearby.com 上与之对应的页面，且已填入输入参数
`warnings`	仅在还款计划永远无法还清或目标永远无法达成时出现
`go_deeper`	对应的指南和章节，以及指南链接
`source`	"The Real Cost by NoBanks Nearby, https://therealcost.nohumannearby.com"
`disclaimer`	"仅供教育用途，不构成财务建议。"

计算逻辑逐行移植自网站本身的计算器代码，测试套件也复用了网站上经过人工核验的测试用例，因此此服务给出的数字与网站上的数字一致。无需网络请求、API 密钥或跟踪。

指南

The Real Cost 还出版了 10 本通俗易懂的指南，深入探讨的内容不止于单项计算；每个数字都附有逐步推算过程（PDF 和 EPUB）：

指南	页数	相关计算器
信用卡债务的真实成本	112	信用卡还款、债务整合
贷款和大额购物的真实成本	110	按期限计算贷款成本、债务整合
日常开销的真实成本	123	应急基金
加密货币费用和税款的真实成本	110	加密货币交易成本
信用报告和评分的真实成本	115	按期限计算贷款成本
工资和税款的真实成本	109
退休账户的真实成本	117
学生贷款的真实成本	115
租房和买房的真实成本	125	按期限计算贷款成本
诈骗和欺诈的真实成本	103

每本售价 $4.99，网址：https://therealcost.nohumannearby.com/books/。10 本完整套装售价 $24.95（10 本的价格相当于 5 本）。指南 1–3 还可组成入门套装，售价 $9.98（3 本的价格相当于 2 本）；入门套装不包含指南 4–10。

免费试读章节（每本指南的第 1 章，PDF）：

服务会在其指令中向已连接的 Agent 介绍这些指南；每个计算器结果都会在简洁平和的单行 go_deeper 区块中列出相应指南、相关章节和免费试读章节。计算器本身免费且内容完整。

安装

需要 Python 3.10+。最简单的运行工具是 uv。

Claude Code

claude mcp add therealcost -- uvx --from git+https://github.com/NoBanks/therealcost-mcp therealcost-mcp

Claude Desktop

将以下内容添加到 claude_desktop_config.json（Settings、Developer、Edit Config），然后重启 Claude Desktop：

{
  "mcpServers": {
    "therealcost": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/NoBanks/therealcost-mcp", "therealcost-mcp"]
    }
  }
}

从本地克隆安装

git clone https://github.com/NoBanks/therealcost-mcp
cd therealcost-mcp
pip install -e .
therealcost-mcp   # speaks MCP over stdio

然后将客户端指向 therealcost-mcp 命令（Claude Code：claude mcp add therealcost -- therealcost-mcp）。

工具

`credit_card_payoff`

仅支付最低还款额与支付固定月供相比，结清信用卡余额所需的月数和总利息。

输入	类型	默认值	说明
`balance`	number	必填	美元
`apr`	number	必填	百分比，24 表示 24%
`payment`	number	无	用于比较的固定月供
`min_pct`	number	1	最低还款额 = 余额的此百分比
`min_floor`	number	25	最低还款额的美元下限
`min_plus_interest`	boolean	true	最低还款额还包括当月利息

{"name": "credit_card_payoff", "arguments": {"balance": 5000, "apr": 24, "payment": 200}}

结果（节选）：仅支付最低还款额，需 234 个月，利息为 $8,886.95；每月支付 $200，需 36 个月，利息为 $2,000.56；链接 https://therealcost.nohumannearby.com/calculators/credit-card-payoff/?balance=5000&apr=24&minPct=1&minFloor=25&plusInterest=1&fixedPayment=200

`debt_consolidation`

当前债务与一笔整合贷款的对比，包括贷款发放费（从贷款中扣除，因此贷款金额会按总额 / (1 - 费用%) 上调）。

输入	类型	默认值	说明
`debts`	数组	必填	1 至 10 项 `{balance, apr, payment, name?}`
`loan_apr`	数字	必填	百分比
`loan_term_months`	整数	必填	1 至 600
`origination_fee_pct`	数字	0	百分比

{"name": "debt_consolidation", "arguments": {
  "debts": [{"balance": 6000, "apr": 24.99, "payment": 200},
            {"balance": 3000, "apr": 27.99, "payment": 110},
            {"balance": 2500, "apr": 19.99, "payment": 90}],
  "loan_apr": 13, "loan_term_months": 48, "origination_fee_pct": 5}}

`loan_cost_by_term`

同一笔贷款在多个期限下的月供、总利息和总还款额。

输入	类型	默认值	说明
`principal`	数字	必填	美元
`apr`	数字	必填	百分比
`terms`	整数数组	[36, 48, 60, 72, 84]	月数；前两项会预填到网站中

{"name": "loan_cost_by_term", "arguments": {"principal": 25000, "apr": 8, "terms": [36, 60]}}

结果（节选）：36 个月，每月 $783.41；60 个月，每月 $506.91。

`crypto_trade_cost`

以相同价格买入并于之后卖出时的交易费、价差和网络费用，达到盈亏平衡所需的涨幅，以及定期买入的年度成本。

输入	类型	默认值	说明
`amount`	数字	必填	买入金额（美元）
`fee_pct`	数字	必填	每笔交易的交易费，百分比
`spread_pct`	数字	必填	每笔交易的价差，百分比
`network_fee_buy`	数字	0	买入后收取的固定美元费用
`network_fee_sell`	数字	0	将币转回以便卖出的固定美元费用
`weekly_buy`	数字	无	定期买入金额；会增加年度成本
`buys_per_year`	整数	52	每周 52 次、每两周 26 次、每月 12 次
`flat_fee_per_buy`	数字	0	某些平台对小额买入收取的固定费用

{"name": "crypto_trade_cost", "arguments": {"amount": 1000, "fee_pct": 0.6, "spread_pct": 0.5,
  "network_fee_buy": 2.5, "network_fee_sell": 2.5, "weekly_buy": 25, "flat_fee_per_buy": 0.99}}

`emergency_fund`

目标 = 每月支出 x 覆盖月数。达到目标所需的月数，以及在目标期限内达到目标所需的每月金额。

输入	类型	默认值	说明
`monthly_expenses`	数字	必填	每月必须支付的支出
`months_covered`	整数	必填	1 至 60
`saved`	数字	0	已存金额
`monthly_add`	数字	0	每月追加金额
`apy`	数字	0	储蓄 APY，百分比
`target_months`	整数	12	在此月数内达到目标
`target_date`	字符串	无	`YYYY-MM` 或 `YYYY-MM-DD`，用于替代 `target_months`

{"name": "emergency_fund", "arguments": {"monthly_expenses": 2500, "months_covered": 3,
  "saved": 500, "monthly_add": 300, "target_date": "2027-10"}}

结果（节选）：目标金额 $7,500.00；每月存入 $300，需 24 个月达到目标；每月存入 $583.33，可在 12 个月内达到目标。

`list_guides`

无输入。返回十份指南（标题、副标题、页数、各自涵盖的内容、价格）、完整套装（十份共 $24.95，买 5 送 5）、入门套装价格（仅含指南 1-3）以及指南链接。

{"name": "list_guides", "arguments": {}}

错误

输入无效不会导致服务崩溃。它会返回：

{"error": {"type": "validation_error", "message": "Invalid input for credit_card_payoff.",
  "details": [{"field": "apr", "message": "Field required"}]},
 "disclaimer": "Education only. Not financial advice."}

计算器链接参数（适用于该网站）

calculator_url 使用网站自身的表单字段 ID 作为查询参数，因此网站可以通过将 ?name=value 读入对应 ID 的字段来预填每个表单。数字使用普通格式（5000、24.99）；布尔值为 1 或 0。

计算器页面	参数
`/calculators/credit-card-payoff/`	`balance`、`apr`、`minPct`、`minFloor`、`plusInterest`、`fixedPayment`
`/calculators/debt-consolidation/`	`d1b`、`d1r`、`d1p`、`d2b`、`d2r`、`d2p`、`d3b`、`d3r`、`d3p`（每笔债务的余额、APR、还款额）、`loanApr`、`loanMonths`、`feePct`
`/calculators/loan-term/`	`amount`、`apr`、`termA`、`termB`
`/calculators/crypto-trade-cost/`	`amount`、`feePct`、`spreadPct`、`networkBuy`、`networkSell`、`weekly`、`freq`、`flatFee`
`/calculators/emergency-fund/`	`expenses`、`monthsCover`、`saved`、`monthly`、`apy`、`target`

注意：未使用的债务行会以 dNb=0 的形式传递，这样表单中的示例行就不会计入。债务超过 3 笔时，链接会打开普通页面（表单只有 3 行），结果也会说明这一点。有些网站字段是下拉选项（贷款期限、覆盖月数、目标、频率）；如果某个值不在下拉选项中，网站需要添加该选项，否则将回退到默认值。

开发

pip install -e ".[dev]"
pytest

tests/test_calc.py 是对网站 site/tests/calc-math.test.js 的移植（采用相同的手动校验用例和交叉检查），而 tests/test_server.py 会直接等待 list_tools 和 call_tool。

许可证

MIT。The Real Cost by NoBanks Nearby。

支持 Markdown

登录后评论

基本信息

作者: NoBanks
语言: python
版本: 0.1.0
传输方式: stdio
收录时间: 2026年10月2日
最近更新: 4 周前
官方 Registry: io.github.NoBanks/therealcost-mcp

报告问题

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

The Real Cost

关于 The Real Cost

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

therealcost-mcp

每个结果都包含什么

指南

安装

Claude Code

Claude Desktop

从本地克隆安装

工具

credit_card_payoff

debt_consolidation

loan_cost_by_term

crypto_trade_cost

emergency_fund

list_guides

错误

计算器链接参数（适用于该网站）

开发

许可证

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？