Sri Lanka Tax (lk-tax)

Name: Sri Lanka Tax (lk-tax)
Author: ShalomHunukumbura

本地服务

github.com/ShalomHunukumbura金融数据03 周前更新

代码仓库

关于 Sri Lanka Tax (lk-tax)

面向 AI 助手的斯里兰卡税务计算 MCP 服务，涵盖 APIT、所得税、预扣税、VAT 和 SSCL，并按日期适用规则且附 IRD 来源。

主要功能

01计算工资税和年度所得税
02计算预扣税
03计算并检查 VAT
04计算并检查 SSCL
05查询指定日期规则及历史

适用场景

01估算指定发薪日的 APIT 扣款
02比较规则变更前后的税额
03检查企业 VAT 或 SSCL 注册要求
04追溯计算所依据的 IRD 文件

MCP 相关

向 MCP 客户端提供只读税务计算和规则查询工具。结果包含适用规则版本及 IRD 来源。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "shalomhunukumbura-lk-tax": {
      "command": "uvx",
      "args": [
        "lk-tax-mcp"
      ]
    }
  }
}

启动命令uvx lk-tax-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypilk-tax-mcp0.1.0stdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
pay_date	any	否	规则适用日期，格式为 YYYY-MM-DD（例如发薪日或发票日期）。默认为今天。
monthly_income	any	是	以斯里兰卡卢比计的金额，例如 350000 或 "350000.50"。

详细介绍

lk-tax-mcp

为 AI 助手提供准确且有来源依据的斯里兰卡税务计算。 一个 MCP 服务，让 Claude（或任何 MCP 客户端）根据斯里兰卡税务局（Inland Revenue Department）的官方规定，计算自 2023 年 1 月 1 日起任意日期的 APIT、所得税、预扣税、VAT 和 SSCL，无需凭记忆回忆税率。

效果展示

以下是仅连接此服务时，Claude Code 的真实会话：

你：我在斯里兰卡工作，月薪为 Rs. 350,000。本月雇主会扣缴多少 APIT？2025 年 4 月调整前又是多少？

Claude 调用两次 calculate_salary_tax，一次针对今天，另一次针对 2025 年 3 月 31 日，并给出如下回答（节选）：

本月：Rs. 32,500 APIT。 每月前 Rs. 150,000 免税，之后依次按 6% / 18% / 24% / 30% 计税。来源：IRD Notice PN/IT/2025-01 和 APIT Tax Table No. 01 (2025/26)。自 2025 年 4 月 1 日起生效。

调整前（截至 2025 年 3 月 31 日）：Rs. 52,500。 每月前 Rs. 100,000 免税，之后依次按 6% / 12% / 18% / 24% / 30% / 36% 计税。来源：APIT Tax Table No. 01 (2023/24 & 2024/25)。

因此，你现在每月少缴 Rs. 20,000。此计算假设这是你的主要工作常规薪酬，且你是斯里兰卡税务居民；一次性奖金或第二份工作适用不同的税表。

数值来自工具，注意事项来自服务的指令，每个数字都可以追溯到一份 IRD 文件。

原因

大模型对税率往往很有把握，但斯里兰卡的税制经常变动：2025 年重新制定了薪资税档；仅在 2026 年，SSCL 起征点就下调了，金融服务 VAT 升至 20.5%，预扣税也扩大至更多职业，且这些变化都发生在年中。模型凭记忆回答“税率”时，遇到某些日期就会出错，也无法提供来源。此服务让模型基于有日期和来源依据的规则进行精确计算，构建于 lk-tax 之上，并已针对 IRD 官方 APIT 税表的每一行进行测试。

安装

需要 uv（uvx 可在无需手动安装的情况下运行此服务）。

Claude Code

claude mcp add lk-tax -- uvx lk-tax-mcp

Claude Desktop：添加到 claude_desktop_config.json（Settings → Developer → Edit Config）：

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

其他 MCP 客户端：运行 uvx lk-tax-mcp，将其作为 stdio 服务；或者运行 pip install lk-tax-mcp 后再运行 lk-tax-mcp。

工具

工具	可回答的问题
`calculate_salary_tax`	应从月薪中扣除的 APIT（官方 Tax Table No. 01 金额）
`calculate_annual_income_tax`	一个评税年度的所得税，附带税档明细
`calculate_withholding_tax`	11 种付款类型的 WHT：起征点、豁免和含税还原
`calculate_vat`	在价格上加收 VAT，或从含 VAT 价格中提取 VAT
`check_vat_registration`	企业是否需要注册 VAT？
`calculate_sscl`	按业务活动计算营业额的 SSCL（应税份额 × 2.5%）
`check_sscl_registration`	企业是否需要注册 SSCL？
`get_tax_rules`	某一日期生效的税率、税档和起征点
`get_rule_history`	自 2023 年以来税务规则的每次变更，包含日期和来源

每个结果都包含一行 summary、以十进制字符串表示的精确金额，以及所用规则版本（effective_from、effective_to、IRD sources）。

设计说明

只读且离线。 每个工具都是纯计算，并标注了 readOnlyHint 和 idempotentHint。不会访问网络、文件或凭据。
明确指定日期。 每次计算都会传入适用日期（发薪日、发票日期），因此询问“去年是多少？”时，会使用去年的规则。
错误信息可供模型采取行动。 输入有误时，工具会返回说明应如何修正的错误（monthly_income must be a number、lk-tax covers 2023-01-01 onwards），而不是笼统的失败信息。
选项均已列出。 付款类型和 SSCL 活动都作为架构中的枚举值，并附有说明，模型可以选择有效选项。
如实说明未涵盖的内容。 服务说明会告知模型未涵盖的情况（一次性付款、非居民员工、VAT 豁免分类、2023 年之前的日期），并要求模型明确说明，而不是估算。

开发

uv sync
uv run pytest                    # includes a test that launches the real command over stdio
uv run mcp dev src/lk_tax_mcp/server.py   # explore the tools in the MCP Inspector

使用 MCP Python SDK v2 构建。