finanzas-mcp

finanzas-mcp

面向 Claude Desktop、Claude Code 或任何 MCP 客户端的通用金融计算器 MCP（Model Context Protocol）服务，支持西班牙语。

25 个纯计算工具：所有工具都基于你提供的数据进行计算——服务不会连接互联网或数据库，也不会保存状态。适用于任何公司和任何货币。

金融计算器 MCP 服务（优先支持西班牙语）：财务比率、杜邦分析、Altman Z-Score、Piotroski F-Score、WACC、CAPM、DCF、倍数、NPV/IRR、盈亏平衡、估值现金转换周期（每天金额，支持多国）、应收账款账龄、折旧、贷款摊销、间接现金流，以及智利税务辅助计算（增值税、企业税、货币调整）。纯计算，不连接外部服务。

工具

模块	工具
比率与诊断	ratios_liquidez · ratios_rentabilidad · ratios_eficiencia（DIO/DSO/DPO/CCC）· ciclo_caja（估值后的 CCC：每天金额 + 多国支持）· ratios_endeudamiento · dupont（3 和 5 因素）· altman_z_score（3 种变体）· piotroski_f_score · working_capital（NOF）
估值	capm_costo_equity（含 Hamada beta）· wacc · dcf（含 WACC×g 敏感性分析）· valoracion_multiplos · van_tir（VAN、TIR、回收期）
运营	punto_equilibrio · variacion（Δ、%、CAGR）· aging_cartera · depreciacion（直线法/加速折旧/年数总和法）· amortizacion_credito（法式/德式）· interes_compuesto · flujo_caja_indirecto
税务（智利，可配置参数）	iva · impuesto_empresa（14A/14D3/custom）· correccion_monetaria · escudo_fiscal · ppm_calculo

约定：利率使用小数表示（0.10 = 10 %），金额使用你选择的货币；在适用时，结果会附带说明。

安装

Claude Desktop / Claude Code（使用 uv）

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

在 Claude Code 中，只需：

claude mcp add finanzas -- uvx finanzas-mcp

从克隆的代码安装

git clone https://github.com/MITDEVPRO/finanzas-mcp
cd finanzas-mcp
uv run finanzas-mcp        # o: pip install -e . && finanzas-mcp

使用示例（在你的 MCP 客户端中）

• “计算流动性：流动资产 850M、流动负债 260M、存货 420M”
• “通过 DCF 估值：FCF 为 1.200、1.350、1.500；WACC 为 11%；g 为 2,5%；净债务为 2.000”
• “Z-Score 是多少？资产 10.000M、负债 6.000M、WC 1.800M、留存收益 2.500M、EBIT 900M、权益 4.000M”
• “生成一笔 50M 贷款的还款表，分 60 期，月利率 1,1%，采用法式还款”
• “为这些发票生成账龄分析：[{monto: 12M, dias_vencido: 45, cliente: 'ACME'}, …]”

想查看完整输出吗？examples/ 中有同一家公司的 4 个已解决案例——WACC → DCF 敏感性分析 → Z-Score → 盈亏平衡——并附有每个工具的实际输出。

对你有帮助吗？

如果 finanzas-mcp 帮你省去了一次计算（或一次委员会讨论），支持它的最佳方式是在这个仓库点一个 ⭐——这能让更多人发现它。如果你需要的计算器还不存在，提交 issue：新工具正是由此而来。

English

finanzas-mcp 是一个 MCP（Model Context Protocol）服务，提供 25 个纯计算型财务计算器，以西班牙语为主，并配有自描述模式。它通过 stdio 在本地运行：无需互联网、数据库或状态——只根据你提供的数字进行计算，因此适用于任何公司和任何货币。

工具：流动性／盈利能力／效率／杠杆比率 · 杜邦分析（3 因子和 5 因子）· Altman Z-Score（3 种变体）· Piotroski F-Score · 营运资本 · CAPM（含 Hamada beta）· WACC · 含敏感性分析的 DCF · 估值倍数 · NPV／IRR／回收期 · 盈亏平衡点 · 现金转换周期估值（每项杠杆对应的美元／天，多国适用）· 应收账款账龄分析 · 折旧 · 贷款摊销（法式／德式）· 复利 · 间接法现金流 · 智利税务辅助工具（增值税、企业所得税、货币调整、税盾——均可参数化）。

安装（Claude Desktop／Claude Code，需要 uv）：

claude mcp add finanzas -- uvx finanzas-mcp

试试这些提示词：“计算 WACC：股权占比 60%，股权成本 12%，债务成本 6%，税率 27%” 或 “对以下数据进行 DCF 估值：FCF 为 1200、1350、1500；WACC 为 11%；g 为 2.5%；净债务为 2000”。工具描述为西班牙语，但 Claude 能无缝衔接不同语言——用英语提问即可正常使用。

如果它帮你完成了一项计算，点一个 ⭐ 星标能帮助其他人找到它。缺少某个计算器？提交 issue。

开发

uv run --group dev pytest        # 20 tests de la matemática financiera

结构：src/finanzas_mcp/ — app.py（FastMCP 实例）+ 4 个工具模块 + server.py（stdio 入口点）。官方 SDK mcp。

免责声明

结果仅供参考和教育用途：不构成财务、税务或投资建议。智利税率（IVA 19 %、14A 27 %、14D3 25 %）为发布时现行税率，并且每个工具中的税率均可参数化。

许可证

MIT

---

mcp-name: io.github.MITDEVPRO/finanzas-mcp