Sheet & Flow Landlord Math

Sheet & Flow 房东计算器（MCP 服务）

将房东和出租房产计算器作为 Model Context Protocol 工具提供，让 Claude、Cursor、VS Code 或任何 MCP 客户端每次都能用相同的方式进行计算，而不是估算。

• 离线且结果确定。 不进行网络调用、不需要 API 密钥，数据不会离开你的计算机。
• 无依赖项。 纯 Node.js（18+），约 380 行代码，可供阅读。
• 经过测试。 在 CI 中，使用 Node 18、20 和 22，通过独立 Python 模型对 552 个随机用例进行了验证，并测试了 Sheet & Flow 教程中的示例。发布前还使用重新计算过的电子表格（LibreOffice）对出租房产计算进行了交叉验证。

工具

工具	可解答的问题
rental_property_analysis	第一年 NOI、月度和年度现金流、资本化率、现金投入回报率、DSCR、租金总额乘数、盈亏平衡入住率、费用率
mortgage_payment	每月本金和利息、利息总额
short_term_rental_analysis	Airbnb/VRBO 的预订晚数、入住次数、总收入、现金流、RevPAR、每个预订晚数的价值、盈亏平衡入住率和盈亏平衡每晚价格
rent_late_fee	逾期天数和滞纳金：宽限期、固定费用 + 百分比费用 + 每日费用、费用上限；可选 Colorado / New York / Texas 示例
lease_renewal_notice	续租或涨租通知必须发出的日期、0-30/31-60/61-90 天窗口、状态、下一次租约结束日期
irs_mileage_deduction_2026	2026 年 IRS 标准里程扣除额（1 月至 6 月每英里 72.5¢，7 月至 12 月每英里 76¢）

百分比使用小数表示（0.25 = 25%）。日期格式为 YYYY-MM-DD。如果传入 7 而不是 0.07 作为百分比，系统会给出明确提示并拒绝计算，而不会悄悄使用错误数值进行计算。

安装

**Claude Desktop（一键安装）：**从最新版本下载 sheet-and-flow-mcp-<version>.mcpb 并打开。

**任何 MCP 客户端（stdio）：**克隆仓库，并将客户端指向 server/index.js：

{
  "mcpServers": {
    "sheet-and-flow": { "command": "node", "args": ["/path/to/sheet-and-flow-mcp/server/index.js"] }
  }
}

**Docker：**运行 docker build -t sheet-and-flow-mcp .，然后在客户端配置中使用 {"command": "docker", "args": ["run", "-i", "--rm", "sheet-and-flow-mcp"]}。

该项目也已列入官方 MCP Registry，名称为 io.github.onyxaholguin-cyber/sheet-and-flow-mcp。

安装为 Agent 插件（Grok Build、Cursor、Claude Code）

此仓库也提供插件：MCP 服务，以及三个用于指导 Agent 在何时以及如何使用它的技能。

技能	用途
landlord-deal-analysis	“这套双拼住宅 / Airbnb 能产生正现金流吗？”；资本化率、现金投入回报率、DSCR、盈亏平衡入住率
rent-late-fee	逾期天数和滞纳金，可选适用 Colorado、New York 和 Texas 的限额
lease-renewal-notice	单份租约或租约列表的续租或涨租通知必须发出的时间

清单文件：.grok-plugin/plugin.json、.cursor-plugin/plugin.json、.claude-plugin/plugin.json；MCP 配置：.mcp.json。

隐私和条款：PRIVACY.md（不会收集任何数据）。

**网络和凭据（供审核者查看）：**运行时均不需要。服务不会进行网络调用、读取文件，也不需要 API 密钥或账户。安装时，.mcp.json 会运行 npx -y github:onyxaholguin-cyber/sheet-and-flow-mcp#<full commit sha>，从 GitHub 下载此仓库在该确切固定提交上的版本（此软件包没有任何依赖项）。如果固定提交中的 server/ 与已测试代码不同，test/plugin_check.py 会使 CI 检查失败。

示例

提问：“Airbnb 房源：售价 350,000 美元，首付 25%，利率 7%，每晚 185 美元，入住率 62%，屏蔽 14 晚，平均入住 3.2 晚，清洁费 95 美元，清洁成本 85 美元，房东费用 15.5%，维护费 9%，每月固定成本 920 美元，交割费用 10,500 美元，家具配置 25,000 美元。现金流为正吗？”

short_term_rental_analysis 会返回以下内容及其他字段：

{ "monthlyCashFlow": -208.64, "keptPerBookedNight": 135.53, "breakEvenOccupancy": 0.6726, "breakEvenNightlyRate": 200.24 }

因此，按给出的条件，这笔交易每月约亏损 209 美元；每晚 185 美元时，入住率需达到 67.3%，或者入住率为 62% 时，每晚价格需达到 200.24 美元。这个示例也在短期租赁计算器教程中逐步演示。

数学原理

每个公式都在免费教程中讲解：

• 资本化率、现金回报率和 DSCR以及免费租赁交易计算器
• 短期租赁的盈亏平衡入住率和每晚价格
• 租金滞纳金计算器（宽限期、上限、各州示例）
• 租约续签跟踪表和通知日期
• IRS 2026 年里程记录表以及里程抵扣计算器

更喜欢使用电子表格？

Sheet & Flow 也提供包含相同计算内容的 Excel / Google Sheets 成品工作簿（付费；此服务免费且采用 MIT 许可，无需购买）： 短期租赁交易分析器 · 出租房产交易分析器 · 房东租户工具包 · 租约续签跟踪表 · 自由职业者里程记录表 · 免费租赁现金流计算器

开发

npm test                       # node --test, no install step
python3 test/model.py          # regenerate fixtures from the independent Python model
python3 scripts/build_mcpb.py  # build dist/*.mcpb and dist/server.json

发布：推送 v* 标签后，会运行测试、构建 .mcpb、将其附加到 GitHub 发布版本，并通过 GitHub OIDC 将 server.json 发布到 MCP Registry（无需存储令牌）。

免责声明

估算结果仅供规划参考，不构成法律、税务或投资建议。滞纳金州法律示例是对截至 2026 年 10 月的法规文本的摘要；收取费用前，请核查现行法律、城市规定和租约。

MIT 许可证 © Sheet & Flow