mcpField
S
Sri Lanka Tax (lk-tax)

Sri Lanka Tax (lk-tax)

ローカル
github.com/ShalomHunukumbura金融データ03 週間前に更新

Sri Lanka Tax (lk-tax) について

スリランカの税金を計算する MCP サーバーです。APIT、所得税、源泉徴収税、VAT、SSCLを日付別の規則と IRD 資料に基づいて算出します。

主な機能

  1. 01給与税と年間所得税の計算
  2. 02源泉徴収税の計算
  3. 03VATの計算と登録確認
  4. 04SSCLの計算と登録確認
  5. 05日付別の規則と履歴の照会

活用シーン

  1. 01支給日に応じた APIT 控除額の見積もり
  2. 02規則改定前後の税額比較
  3. 03事業者の VAT・SSCL 登録要件の確認
  4. 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.0

ツール

9

掲載時のツール一覧 · 3 週間前に更新

パラメーター型必須説明
pay_dateanyいいえルールの適用日。YYYY-MM-DD 形式(例:給与支払日または請求書の日付)。既定値は今日です。
monthly_incomeanyはいスリランカルピー建ての金額。例:350000 または "350000.50"。

詳細

lk-tax-mcp

M8ven Score

AI アシスタント向けの、正確で出典を明示したスリランカの税額計算です。 MCP サーバーを使うと、Claude(または任意の MCP クライアント)が、記憶に頼ることなく、2023 年 1 月 1 日以降の任意の日付について、歳入庁の公式ルールに基づき APIT、所得税、源泉徴収税、VAT、SSCL を計算できます。

使用例

このサーバーだけを接続した、実際の Claude Code セッションです。

あなた: スリランカで月 Rs. 350,000 の給与をもらっています。今月、雇用主はいくら APIT を天引きしますか?また、2025 年 4 月の変更前はいくらでしたか?

Claude は calculate_salary_tax を 2 回呼び出します。1 回は今日の日付、もう 1 回は 2025 年 3 月 31 日を指定し、次のように回答します(抜粋)。

今月:APIT は Rs. 32,500 です。 月 Rs. 150,000 までは非課税で、その後は 6%/18%/24%/30% です。 出典:IRD 通知 PN/IT/2025-01 および APIT 税額表 No. 01(2025/26)。2025 年 4 月 1 日から適用。

変更前(2025 年 3 月 31 日まで):Rs. 52,500 です。 月 Rs. 100,000 までは非課税で、その後は 6%/12%/18%/24%/30%/36% です。出典:APIT 税額表 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_tax1 か月分の給与から天引きする APIT(公式税額表 No. 01 の金額)
calculate_annual_income_tax年度の所得税と税率帯ごとの内訳
calculate_withholding_tax11 種類の支払いに対する WHT:基準額、免除、グロスアップ
calculate_vat価格に VAT を加算、または VAT 込み価格から VAT を算出
check_vat_registration事業者に VAT 登録が必要かどうか
calculate_sscl事業活動別の売上高に対する SSCL(課税対象の割合 × 2.5%)
check_sscl_registration事業者に SSCL 登録が必要かどうか
get_tax_rules指定日に適用される税率、税率帯、基準額
get_rule_history2023 年以降の税制変更すべてと、その日付および出典

各結果には、1 行の summary、10 進文字列で示された正確な金額、適用されたルールのバージョン(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 で構築されています。

免責事項

税務アドバイスではありません。結果には参照元の IRD の資料へのリンクが記載されているため、確認できます。

ライセンス

MIT

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。