budongsan-tax

Name: budongsan-tax
Author: taylee9809

本地服务

github.com/taylee9809金融数据12 周前更新

代码仓库

关于 budongsan-tax

budongsan-tax 是以 MCP 服务形式提供的韩国房地产税计算与资格判定引擎，涵盖多种房地产相关税费。每项结果都附上适用及未适用的法条，以及输入值来源等级。

主要功能

01计算七类房地产相关税费
02判定资格与免税条件
03结果附带法条依据
04以官方解释案例进行回归测试
05提供法规与裁决查询工具

适用场景

01估算韩国取得税或财产税
02核对税收减免资格
03查看计算所依据的法条
04查询相关法规与官方裁决

MCP 相关

它提供 43 个 MCP 工具，用于税务判定、计算、住房数量统计及法律资料查询。法规和裁决检索工具需要法制处 Open API 密钥。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "taylee9809-budongsan-tax": {
      "command": "uvx",
      "args": [
        "budongsan-tax"
      ],
      "env": {
        "LAW_OC": "<LAW_OC>"
      }
    }
  }
}

启动命令uvx budongsan-tax

需要配置的环境变量

LAW_OC密钥law.go.kr Open API key. Optional; only the statute and ruling lookup tools need it.

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

安装包

pypibudongsan-tax0.1.1stdio

工具

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

参数	类型	必填
query	string	是
target	string	否
display	integer	否

详细介绍

budongsan-tax

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

这是一个用于计算和判定韩国房地产税的引擎，以 MCP 服务的形式运行。涵盖取得税、财产税、综合不动产税、资本利得税、住房租赁所得税、赠与税和遗产税（房地产），以及重建负担金。

每项结果都会同时列出所适用的条文、查看过但未适用的条文及其原因，以及输入值的来源等级。

以国税厅、税务审判院、行政安全部的官方解释案例和裁决案例为标准答案进行回归测试。

这不是税务代理服务。结果只是解读条文的一种方式。申报和申诉请咨询税务师或律师。不保证准确性（AGPL §15、§16）。

English. 韩国房地产税引擎和 MCP 服务：取得税、财产税、综合持有税、资本利得税、租赁所得税、赠与税和遗产税、重建负担金。43 个工具， 2431 个法规节点（每个条、款或项对应一个函数），以官方裁决作为回归测试。每项结果都附有法规依据链。英文 README：README-EN.md。工具列表：llms.txt。

数字


MCP 工具	43
执行节点	2431（每个条、款或项对应一个函数）
待迁移条文	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 个工具。旧结构中一个函数包含多个条文
4 执行节点	`tax_nodes/`	每个条文对应一个函数。计算是合成多个节点的结果。正在用这一层替换第 3 层
验证	`data/verification/`, `tax_case_store.py`	用例、缺陷、解释案例

各条文的迁移状态见 docs/NODE_COVERAGE.md。各税种的验证结果和不一致数量见 docs/BENCH.md；附有条文依据的实际输出示例见 docs/EXAMPLE.md。语料库中没有原文的条文（尚未着手处理），应先补充原文。

安装

已发布到 PyPI。有 uv 的话，无需安装即可直接运行。

uvx budongsan-tax

Claude Code 一行命令：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"]}}}

用于回归测试的数据库（可选）：

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。指出一个错误结果，并用一行记录为用例，就是最大的贡献。即使不懂代码也可以参与。

来源和版权

法律、施行令、条例：法制处国家法令信息中心。根据著作权法 §7 第 1 项，不属于保护对象
税务审判院裁决、国税厅和行政安全部的解释案例：著作权法 §7 第 2、3 项。此处仅收录发布机构已去标识化的原文，并再次删除数字模式后，仅提供摘要（scripts/sanitize_public_text.py）。正文只保留 sha256
本仓库的代码、节点和用例：AGPL-3.0-or-later