budongsan-tax

budongsan-tax

mcp-name: io.github.taylee9809/budongsan-tax

韓国の不動産税を計算・判定するエンジンです。MCP サーバーとして動作します。 取得税、財産税、総合不動産税、譲渡所得税、住宅賃貸所得税、不動産の贈与税・相続税、再建築負担金を扱います。

各結果には、適用した条文、確認したものの適用しなかった条文とその理由、入力値の出典の等級が含まれます。

国税庁、租税審判院、行政安全部の公式解釈例と裁決例を正解として、回帰テストを実行します。

税務代理ではありません。結果は条文の読み方の一つです。申告や不服申立ては税理士、弁護士にご相談ください。 正確性は保証しません（AGPL §15、§16）。

English. 韓国の不動産税エンジンおよびMCPサーバーです。取得税、財産税、総合不動産税、譲渡所得税、賃貸所得税、贈与税・相続税、再建築負担金を扱います。43個のツール、2431個の条文ノード（条・項ごとに1つの関数）、公式裁決例を回帰テストに使用します。 すべての結果に条文の根拠が付いています。英語版 README：README-EN.md。ツール一覧：llms.txt。

数字

MCP ツール	43
実行ノード	2431（条・項・号ごとに1つの関数）
移行待ちの条文	0（法文コーパスにある税額に影響する条文はすべて移行済みです）
回帰ケース／解釈例／不具合記録	307／1318／40

構造

層	場所	内容
1 値	data/tax_params.json, tax_params.py	税率表、割合、上限。年別。検証されていない年は返しません
2 法文	data/legal_nodes/	条文の原文と施行日。結果の根拠フィールドはここを参照します
3 判定・計算	tax_judgment.py, tax_server.py, entity_tax.py	43個のツール。1つの関数に複数の条文が含まれる従来の構造
4 実行ノード	tax_nodes/	1つの条文につき1つの関数。計算はノードを合成した結果です。第3層をこれに置き換えています
検証	data/verification/, tax_case_store.py	ケース、不具合、解釈例

条文ごとの移行状況はdocs/NODE_COVERAGE.mdをご覧ください。 税目ごとの検証結果と不一致件数はdocs/BENCH.md、条文の根拠が付いた実際の出力例はdocs/EXAMPLE.mdにあります。 コーパスに原文がない条文（未着手）は、原文を追加することが先決です。

インストール

PyPIで公開しています。uvがあれば、インストールなしですぐに起動できます。

uvx budongsan-tax

Claude Codeでの1行コマンド：claude mcp add budongsan-tax -- uvx budongsan-tax

ソースから実行する場合：

pip install -r requirements.txt
cp .env.example .env      # 법령·해석례 조회 도구를 쓰려면 LAW_OC(법제처 Open API 키, 무료). 계산은 없어도 된다
python tax_server.py      # stdio MCP 서버

Claude Code：

claude mcp add budongsan-tax -- python /절대경로/tax_server.py

Claude Desktopのclaude_desktop_config.json：

{"mcpServers": {"budongsan-tax": {"command": "python", "args": ["/절대경로/tax_server.py"]}}}

回帰テスト用DB（任意）：

python scripts/verification_sync.py --rebuild
python -m pytest tests

ツール

名前の接頭辞で役割が分かれています。judge_*は世帯、住宅数、非課税や減免の要件などの事実を判定します。先に実行します。 calc_*はその判定を受けて税額を算出します。count_*は住宅数を数えます。search_*とget_*は法令、条例、解釈例を 検索します。利用にはLAW_OCが必要です。

一覧と各ツールの簡単な説明はllms.txtをご覧ください。

似た名前のサーバーとの違いについて。法令・解釈例の検索サーバー（例：korean-tax-mcp）は原文を探し、判断はAIに委ねます。 このリポジトリは逆に、税額を計算して要件を判定し、その根拠となる条文を結果に付けます。両者は役割が重複せず、併用できます。

リモート（HTTP）で起動するには、MCP_TRANSPORT=streamable-http budongsan-taxまたはDockerfileを使用します。エンドポイントは/mcpで、認証はありません。 各ツールにtitleとreadOnlyHintが付いているため、コネクターディレクトリへの登録要件を満たしています。

貢献

CONTRIBUTING.mdをご覧ください。誤った結果をケース1行で報告していただくことが、最も大きな貢献になります。 コードの知識は必要ありません。

出典と著作権

• 法律、施行令、条例：法制処国家法令情報。著作権法§7第1号に基づき、保護の対象ではありません
• 租税審判院の決定、国税庁・行政安全部の解釈例：著作権法§7第2号、第3号。発行機関が非識別化した原文であり、ここでは 数値パターンをさらに削除した要約のみを掲載します（scripts/sanitize_public_text.py）。本文はsha256のみを保存します
• このリポジトリのコード、ノード、ケース：AGPL-3.0-or-later

ライセンス

GNU Affero General Public License v3.0 or later。変更を加えてネットワークサービスとして公開する場合、変更したソースを同じ条件で 公開する必要があります。クローズドサービスに組み込む場合は、別途お問い合わせください。

---

生成元：scripts/package_opensource.py（元のgit 6116176）