内容
# finanzas-mcp
[](https://github.com/MITDEVPRO/finanzas-mcp/actions/workflows/ci.yml) [](https://pypi.org/project/finanzas-mcp/)
**金融计算器** （Model Context Protocol）服务端，提供**通用金融计算工具**，支持中文，可与 Claude Desktop、Claude Code 或任意 MCP 客户端配合使用。
**25种纯计算工具**：所有工具均基于用户提供的数据进行计算，**服务端不会连接互联网、数据库或保存状态**。适用于任何企业，支持任意货币。
> *金融计算器作为MCP服务端（优先支持中文）：比率、杜邦分析、Altman Z评分、Piotroski F评分、WACC、CAPM、DCF、倍数、NPV/IRR、盈亏平衡点、应收账款账龄、折旧、贷款摊销、间接现金流、以及 Chilean税务助手（增值税、公司税、货币修正）。纯计算，无外部连接。*
## 工具列表
| 模块 | 工具 |
|---|---|
| **比率与诊断** | `比率分析` · `盈利能力比率` · `效率比率` （DIO/DSO/DPO/CCC）· `负债比率` · `杜邦分析` （3 和 5 因素）· `Altman Z评分` （3 种变体）· `Piotroski F评分` · `营运资本` （NOF）|
| **估值** | `CAPM股权成本` （含Hamada beta）· `WACC` · `DCF` （含WACC×g 敏感性分析）· `倍数估值` · `VAN_TIR` （VAN, TIR, 回报期）|
| **运营** | `盈亏平衡点` · `变动分析` （Δ, %, CAGR）· `应收账款账龄` · `折旧` （直线/加速/数字总和）· `贷款摊销` （法国/德国方式）· `复利` · `间接现金流` |
| **税务（Chile，可参数化）** | `增值税` · `企业税` （14A/14D3/自定义）· `货币修正` · `税收盾` · `PPM计算` |
约定：**利率以小数表示** （`0.10` = 10 %），金额使用您习惯的货币单位，结果包含解释说明。
## 安装
### Claude Desktop / Claude Code （搭配 [uv](https://docs.astral.sh/uv/)）
```json
{
"mcpServers": {
"finanzas": {
"command": "uvx",
"args": ["finanzas-mcp"]
}
}
}
```
在 Claude Code 中，只需执行：
```bash
claude mcp add finanzas -- uvx finanzas-mcp
```
### 从克隆的代码开始
```bash
git clone https://github.com/MITDEVPRO/finanzas-mcp
cd finanzas-mcp
uv run finanzas-mcp # 或：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 评分：资产 10,000M，负债 6,000M，营运资本 1,800M，留存收益 2,500M，EBIT 900M，权益 4,000M"*
- *"一张 50M 贷款的还款计划，分 60 期，月利率 1.1%，法国式还款"*
- *"计算这些发票的账龄：[{金额：12M，逾期天数：45，客户：'ACME'}，…]"*
## 开发
```bash
uv run --group dev pytest # 20 个金融数学测试
```
项目结构：`src/finanzas_mcp/` — `app.py` （FastMCP 实例）+ 4 个工具模块 + `server.py` （标准输入输出入口）。官方 SDK [`mcp`](https://github.com/modelcontextprotocol/python-sdk).
## 免责声明
结果仅**供参考和教育使用**：不构成金融、税务或投资建议。智利税率（增值税 19%，14A 27%，14D3 25%）为发布时的有效税率，**可参数化**。
## 许可证
[MIT](LICENSE)
---
`mcp-name: io.github.MITDEVPRO/finanzas-mcp`
