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、損益分岐点、金額換算したキャッシュ・コンバージョン・サイクル（1日あたりの金額、複数国対応）、売掛金のエイジング、減価償却、ローン返済、間接法によるキャッシュフロー、チリの税務ヘルパー（VAT、法人税、貨幣価値修正）。純粋な計算のみで、外部接続はありません。

ツール

モジュール	ツール
比率と診断	ratios_liquidez · ratios_rentabilidad · ratios_eficiencia (DIO/DSO/DPO/CCC) · ciclo_caja (金額換算した CCC：1日あたりの金額＋複数国対応) · ratios_endeudamiento · dupont (3要素・5要素) · altman_z_score (3種類) · piotroski_f_score · working_capital (運転資本需要)
企業価値評価	capm_costo_equity (Hamada のベータを含む) · wacc · dcf (WACC×g の感度分析を含む) · valoracion_multiplos · van_tir (NPV、IRR、投資回収期間)
業務	punto_equilibrio · variacion (Δ、%、CAGR) · aging_cartera · depreciacion (定額法／加速償却／年数総和法) · amortizacion_credito (フランス式／ドイツ式) · interes_compuesto · flujo_caja_indirecto
税務（チリ、パラメーター設定可能）	iva · impuesto_empresa (14A/14D3/カスタム) · 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、運転資本1,800M、利益剰余金2,500M、EBIT 900M、純資産4,000M」
• 「5,000万を月利1.1%で60回払い、フランス式で返済するローンの返済表を作って」
• 「次の請求書のエイジングをして：[{monto: 12M, dias_vencido: 45, cliente: 'ACME'}, …]」

出力の全体を見たいですか？examples/ には、同じ企業を題材にした4つの解決例（WACC → 感度分析付きDCF → Z-Score → 損益分岐点）があり、各ツールの実際の出力を確認できます。

役に立ちましたか？

finanzas-mcp によって計算の手間（または委員会での議論）が省けたなら、応援する一番の方法は、このリポジトリに ⭐ を付けることです。より多くの人に見つけてもらえるようになります。また、必要な計算ツールがない場合は、issue を作成してください。新しいツールはそこから生まれます。

English

finanzas-mcp は、25 個の純粋計算型金融計算ツールを備えた MCP（Model Context Protocol）サーバーです。スペイン語を優先し、自己記述型スキーマを使用します。stdio 経由でローカル実行され、インターネット、データベース、状態管理は不要です。提供された数値のみを計算するため、あらゆる企業や通貨で利用できます。

ツール：流動性／収益性／効率性／レバレッジ比率 · DuPont（3 因子・5 因子） · Altman Z-Score（3 種類） · Piotroski F-Score · 運転資本 · CAPM（Hamada ベータ付き） · WACC · 感度分析付き DCF · バリュエーション倍率 · NPV／IRR／回収期間 · 損益分岐点 · 金額換算したキャッシュ・コンバージョン・サイクル（指標ごとに $／日、複数国対応） · 売掛金のエイジング分析 · 減価償却 · ローンの償却（フランス式／ドイツ式） · 複利 · 間接法によるキャッシュフロー · チリの税務計算ツール（VAT、法人税、貨幣修正、タックスシールド — すべてパラメーター設定可能）。

インストール（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