汇率与税务计算服务

一个基于Spring Boot的应用,提供美元兑换格鲁吉亚拉里的汇率查询和税务计算功能,适用于需要处理跨境财务和税务的场景。

  • by paolo-dat
  • Java
  • 本地部署
  • 更新于
在 GitHub 查看 paolo-dat/tax-mcp-server

使用说明

MCP服务器

一个Spring Boot应用程序,它提供了两个工具,用于处理美元汇率和计算格鲁吉亚拉里(GEL)的税款。它从格鲁吉亚国家银行(NBG)检索官方汇率,并根据用户输入帮助计算纳税义务。

特性

  • 获取美元汇率: 从格鲁吉亚国家银行检索给定日期的官方美元兑GEL汇率。
  • 计算税额: 根据以美元为单位的收入金额、汇率和税收百分比计算以GEL为单位的税款。

外露工具

1.️⃣ 获取美元汇率

说明:
从格鲁吉亚国家银行获取特定日期的官方美元汇率。

方法签名:

public double fetchUsdRate(String date)

参数:

  • date (字符串,必填) –目标日期 yyyy-MM-dd 格式。

示例用法:

GET https://nbg.gov.ge/gw/api/ct/monetarypolicy/currencies/?currencies=USD&date=2024-01-01

答复: 返回官方美元对GEL的汇率,四舍五入到小数点后4位。


2.️⃣ 计算税额

说明:
使用以下公式计算GEL中的税额:

  • 收入金额(美元)
  • 指定日期的货币汇率
  • 税率百分比

方法签名:

public double calculateTaxValue(double incomeAmount, double currencyExchangeRate, double taxRatePercentage)

参数:

  • incomeAmount (双倍,必填) –待转换和征税的美元收入金额。
  • currencyExchangeRate (双倍,必填) –美元对GEL的汇率。
  • taxRatePercentage (双倍,必填) –税率百分比。

公式:

taxValue = (incomeAmount * currencyExchangeRate * taxRatePercentage) / 100

答复: 返回以GEL为单位的计算税额,四舍五入到小数点后4位。


示例流程

  1. 获取汇率:

    • 呼叫 fetchUsdRate("2024-01-01") → 例如,2.6789 GEL/USD
  2. 计算税款:

    • 呼叫 calculateTaxValue(1000, 2.6789, 20) → 535.7800 GEL