Skip to main content
Glama
zisu17
by zisu17

nts-taxlaw-mcp

这是一个直接查询韩国国税厅国税法令信息系统https://taxlaw.nts.go.kr)原件的MCP服务器。

使用Python和FastMCP实现,不经过法制处镜像(ntsCgmExpc),直接使用国税厅自身的查询端点。

  • 查询最新税法解释例

  • 结构化呈现回信、判断、结论等详细正文

  • 基于文档编号的精确查找

  • 搜索判例、决定例及行政解释标准

  • 包含来源和依据类型的结构化响应

现有的korean-law-mcp由于法制处OPEN API的特性,虽然可以搜索国税厅解释例的列表,但在详细正文查询方面存在限制。nts-taxlaw-mcp通过直接查询国税厅原件,提供文档编号搜索和详细正文查询功能。


1. 支持的数据

领域

对象

搜索

文档编号查询

正文

税法解释例

预答、质疑回复(书面质疑)、课税标准咨询、告示书面质疑

O

O

要点、事实关系、质疑内容、回复、相关法令

判例·决定例

课税是否适当、异议申请、审查请求、审判请求、判例、宪法法院

O

O

处分概要、申请人主张、处分厅意见、审理及判断、结论

行政解释标准

国税基本通则

O

-

条款正文

行政解释标准

税法执行标准

O

-

条款名称·目录

行政解释标准

国税厅告示206件、训令143件

O

-

元数据

附表·格式

法令格式34,487件

O

-

元数据·文件标识符

收录规模

以下为2026年8月实测数据。

数据

件数

质疑回复

132,638

预答

5,117

预判标准咨询

1,036

告示书面质疑

14

税法解释整理

996

税务是否

518

异议申请

1,478

审查请求

22,233

裁决请求

71,349

判例

55,860

宪法法院

355

不支持的数据

数据

原因

法律·施行令·施行规则正文

国家法令信息中心为原件,由korean-law-mcp提供

税收条约

法制处条约API更稳定,因此不重复实现

一般判例·宪法法院决定全部

仅查询赋予税目的税收案件

税法执行标准条款正文

原件以年度PDF形式发布,仅提供目录·条款名称·PDF文件ID

表格文件二进制

采用POST表单下载方式,无稳定的GET URL

审计院审查请求·纳税人保护委员会审议案例·评估审议案例

目前未通过单独模块·操作实现

出版物·税目摘要信息·术语词典·税务日程

非法律依据的指导资料,目前不支持

更多调查内容请参考docs/INVESTIGATION.md


Related MCP server: korean-engineering-mcp

2. 数据来源

所有数据均查询自国税厅国税法令信息系统

https://taxlaw.nts.go.kr

  • 使用公开查询端点POST /action.do

  • 不绕过登录、CAPTCHA、访问控制

  • 无需单独会话、Cookie、认证密钥

  • 所有响应均包含原始追踪信息

{
  "sourceAgency": "국세청",
  "sourceSystem": "국세법령정보시스템",
  "sourceId": "200000000000022584",
  "documentNumber": "서면-2026-법규재산-0119",
  "sourceUrl": "https://taxlaw.nts.go.kr/qt/USEQTA002P.do?ntstDcmId=200000000000022584",
  "retrievedAt": "2026-08-19T13:34:58Z"
}

3. 文档编号搜索

通过规范化文档编号的表示差异,查询同一文档。

서면-2026-법규재산-0119
서면 2026 법규재산 0119
서면2026법규재산0119
서면서면-2026-법규재산-0119
질의회신 서면-2026-법규재산-0119
질의회신서면-2026-법규재산-0119
국세청 서면-2026-법규재산-0119

已确认的文档编号格式如下。

格式

结构

示例

A

类型-年份-分类-序列

서면-2026-법규재산-0119, 사전-2026-법규소득-0543, 조심-2025-인-4460

B

类型-机构-年份-序列

적부-국세청-2026-0119, 이의-광주청-2026-0024, 심사-부가-2026-0018

C

机构 部门-序列

재정경제부 국제조세협력과-104

A和B通过第二项是否为4位年份来区分。

精确匹配原则

정확히 일치
→ found: true
→ exactMatch: true
→ document 반환

일치 없음
→ NOT_FOUND
→ similarDocuments 별도 반환

部分匹配的文档不会作为正确答案返回。

lookup_tax_document("법규재산-0119")

→ [NOT_FOUND]

similarDocuments:
  · 서면-2026-법규재산-0119
  · 서면-2015-징세-0119
  · 기준-2023-법규부가-0044
  · 적부-국세청-2020-0119

similarDocuments是搜索辅助信息,不视为请求的文档。

如果仅存在0119119等零填充差异,则视为同一文档编号。规范化仅用于扩展查询候选,最终响应中仍返回国税厅原件的文档编号。


4. 关键词搜索

基于国税法令信息系统的实际搜索结果应用搜索语法。

输入

件数

含义

["상속"]

22,349

单一关键词

["증여"]

22,924

单一关键词

["상속","증여"]

14,913

AND

["상속 증여"]

14,913

AND

["상속|증여"]

30,360

OR

["상속"] + 排除 ["증여"]

7,436

NOT

在MCP中按如下方式使用。

{"query": "상속 공동상속주택"}                  # AND
{"query": "상속 증여", "match": "any"}         # OR
{"query": "상속", "exclude": ["증여"]}         # NOT
{"query": '"공동상속주택 소수지분" 양도'}       # 구절 검색

搜索时请注意以下事项:

  • OR运算符使用ASCII竖线|

  • ¦(U+00A6)不能作为OR使用。

  • 传递错误的排序字段不会报错,而是返回0条结果。

  • 服务器仅使用实测验证的DCM_RGT_DTMFRS_RGT_DTMSCORE


5. 安装

无需直接安装Python或手动创建虚拟环境。uv会管理所需的Python和包。

5.1 安装uv

Windows

PowerShell:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

如果公司政策限制脚本执行:

winget install --id=astral-sh.uv -e

macOS / Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

安装后重新打开终端并确认。

uv --version

5.2 服务器安装

可直接从GitHub地址安装。

uv tool install git+<GitHub 주소>

安装后,可在任意路径下执行nts-taxlaw-mcp命令。

确认安装位置:

(Get-Command nts-taxlaw-mcp).Source
which nts-taxlaw-mcp

常见安装路径:

OS

路径

Windows

C:\Users\<用户>\.local\bin\nts-taxlaw-mcp.exe

macOS / Linux

~/.local/bin/nts-taxlaw-mcp

更新:

uv tool upgrade nts-taxlaw-mcp

卸载:

uv tool uninstall nts-taxlaw-mcp

5.3 源码安装

如需修改代码或运行测试,请下载仓库使用。

git clone <GitHub 주소>
cd nts-taxlaw-mcp
uv sync

uv sync执行以下操作:

  • 检查并安装符合requires-python = ">=3.11"的Python

  • 在项目目录中创建.venv

  • 根据uv.lock安装依赖

无需手动激活虚拟环境。后续命令通过uv run执行。

在无法使用git的环境中,可通过GitHub的Code > Download ZIP下载后解压并运行uv sync

验证运行:

uv run nts-taxlaw-mcp --help
uv run python scripts/compare_with_site.py

5.4 确认PATH

安装后若找不到uvnts-taxlaw-mcp命令,请重新打开终端后确认。

uv tool update-shell

在Windows中使用绝对路径确认:

& "$env:USERPROFILE\.local\bin\uv.exe" --version

macOS / Linux:

~/.local/bin/uv --version

6. Claude Code连接

使用uv工具安装时

claude mcp add nts-taxlaw -- nts-taxlaw-mcp

如果找不到命令,请确认安装路径后指定绝对路径。

claude mcp add nts-taxlaw -- "C:\Users\<사용자>\.local\bin\nts-taxlaw-mcp.exe"

从仓库运行时

claude mcp add nts-taxlaw -- uv run --directory /절대경로/nts-taxlaw-mcp nts-taxlaw-mcp

注册确认:

claude mcp list

HTTP连接

服务器运行:

nts-taxlaw-mcp --http --port 8000

Claude Code注册:

claude mcp add --transport http nts-taxlaw http://127.0.0.1:8000/mcp

7. Claude Desktop连接

配置文件:

OS

路径

Windows

%APPDATA%\Claude\claude_desktop_config.json

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

在Claude Desktop中,指定可执行文件的绝对路径更稳定。

Windows

uv tool安装:

{
  "mcpServers": {
    "nts-taxlaw": {
      "command": "C:\\Users\\<사용자>\\.local\\bin\\nts-taxlaw-mcp.exe"
    }
  }
}

从仓库运行:

{
  "mcpServers": {
    "nts-taxlaw": {
      "command": "C:\\Users\\<사용자>\\.local\\bin\\uv.exe",
      "args": [
        "run",
        "--directory",
        "C:\\Users\\<사용자>\\nts-taxlaw-mcp",
        "nts-taxlaw-mcp"
      ]
    }
  }
}

在JSON中,Windows路径的反斜杠需写成\\。也可以使用/

macOS

uv tool安装:

{
  "mcpServers": {
    "nts-taxlaw": {
      "command": "/Users/<사용자>/.local/bin/nts-taxlaw-mcp"
    }
  }
}

从仓库运行:

{
  "mcpServers": {
    "nts-taxlaw": {
      "command": "/Users/<사용자>/.local/bin/uv",
      "args": [
        "run",
        "--directory",
        "/Users/<사용자>/nts-taxlaw-mcp",
        "nts-taxlaw-mcp"
      ]
    }
  }
}

实际路径可通过以下命令确认。

(Get-Command nts-taxlaw-mcp).Source
which nts-taxlaw-mcp

与korean-law-mcp一起使用

建议使用korean-law-mcp查询法律·施行令·施行规则正文,使用nts-taxlaw-mcp查询国税厅特有资料。

{
  "mcpServers": {
    "korean-law": {
      "command": "npx",
      "args": ["-y", "korean-law-mcp"],
      "env": {
        "LAW_OC": "발급받은-인증키"
      }
    },
    "nts-taxlaw": {
      "command": "C:\\Users\\<사용자>\\.local\\bin\\nts-taxlaw-mcp.exe"
    }
  }
}

pip + venv

在无法使用uv的环境中,可手动安装Python 3.11或更高版本,并按传统方式运行。

git clone <GitHub 주소>
cd nts-taxlaw-mcp

python3 -m venv .venv
source .venv/bin/activate
pip install -e .

python -m nts_taxlaw_mcp --help

Windows虚拟环境激活:

.venv\Scripts\activate

在Claude Desktop中指定虚拟环境中Python的绝对路径。

{
  "mcpServers": {
    "nts-taxlaw": {
      "command": "/절대경로/nts-taxlaw-mcp/.venv/bin/python",
      "args": ["-m", "nts_taxlaw_mcp"]
    }
  }
}

8. 环境变量

所有项均为可选,仅使用默认值即可运行。

变量

默认值

说明

NTS_TIMEOUT_MS

20000

请求超时(毫秒)

NTS_RETRIES

3

重试次数

NTS_RATE_PER_MIN

60

每分钟请求限制

NTS_RATE_BURST

20

突发允许量

NTS_BODY_LIMIT

30000

正文最大字符数

NTS_CACHE_MAX

600

缓存最大条目数

NTS_USER_AGENT

Chrome UA

User-Agent


9. MCP工具

共提供9个工具。

工具

用途

lookup_tax_document

文档编号精确查询

search_tax_interpretations

税法解释例搜索

search_tax_decisions

判例·决定例搜索

get_tax_document

解释例·决定例正文查询

search_tax_guidance

基本通则·执行标准·告示·训令搜索

get_tax_guidance

通则·执行标准特定条款查询

search_tax_forms

法令格式·附表搜索

search_taxlaw

全领域综合搜索

tax_research

针对税务问题的分层依据收集

如果已知文档编号,请优先使用lookup_tax_document

get_tax_document将解释例和决定例的详细查询整合为一个工具。由于国税法令信息系统的详细查询操作与文档类型无关,因此不将其拆分为单独的详细查询工具。

使用示例

文档编号查询:

{
  "name": "lookup_tax_document",
  "arguments": {
    "document_number": "서면-2026-법규재산-0119"
  }
}

响应示例:

[OK]

found: true
exactMatch: true

서면-2026-법규재산-0119
질의회신 | 양도소득세 | 2026-08-11 | nts_ruling

title:
인구감소지역 내 취득한 분양권이 ’27.1.1.이후 주택으로 전환된 경우 조특법§71의2 적용 여부

relatedLaws:
- 조세특례제한법 제71조의2
- 조세특례제한법 시행령 제68조의2

sections:
- facts
- question
- relatedLawsText

判例·决定例搜索:

{
  "name": "search_tax_decisions",
  "arguments": {
    "query": "공동상속주택",
    "type": "court",
    "result": ["국승"],
    "limit": 3
  }
}

基本通则搜索:

{
  "name": "search_tax_guidance",
  "arguments": {
    "kind": "basic_ruling",
    "law_name": "상속세 및 증여세법",
    "query": "상속재산"
  }
}

税务问题依据收集:

{
  "name": "tax_research",
  "arguments": {
    "question": "부모가 자녀에게 시가보다 낮은 가격으로 아파트를 양도하면 증여세가 발생하는지"
  }
}

10. 法律依据分类

税务资料根据依据的性质进行分类返回。

含义

statute

法律

enforcement_decree

施行令

enforcement_rule

施行规则

nts_ruling

国税厅解释例·例规

nts_guidance

基本通则·执行标准·告示·训令

adjudication

税务是否·异议申请·审查请求·裁决请求

court_case

法院判例·宪法法院决定

国税厅例规是税务当局的法律解释,不约束法院。基本通则和执行标准是内部执行标准,并非法律本身。


11. 错误处理

区分资料实际不存在与原始服务器问题导致无法查询的情况。

错误代码

含义

可判断为不存在

NOT_FOUND

原件中无匹配资料

O

DETAIL_NOT_AVAILABLE

文档存在但原件不提供正文

X

UPSTREAM_ERROR

国税厅错误·维护·异常响应

X

PARSE_ERROR

响应格式与预期不符

X

RATE_LIMITED

超过服务器自身请求限制

X

TIMEOUT

请求超时

X

INVALID_INPUT

输入错误

X

错误响应中包含guardrail信息,以防止模型生成未经确认的正文或结论。

即使HTTP 200响应,如果返回维护页面HTML或正文异常为空,也会视为临时故障并重试。


12. 请求限制及缓存

为避免对国税法令信息系统造成过多请求,限制调用量并减少重复查询。

请求限制

  • 默认请求限制:每分钟60次

  • 突发允许量:最大20次

  • 考虑tax_research等单次任务中连续多次请求的情况,采用令牌桶方式

缓存

目标

保留时间

搜索结果

30分钟

文档正文

24小时

通则·执行标准·告示·训令

12小时

法令列表

7天

重复请求处理

当相同请求同时到达时,仅执行一次实际国税法令信息系统查询,并共享结果。

HTTP连接复用

使用httpx的keep-alive连接池。


13. 免责声明

  • 本服务器是用于国税厅原文搜索和结构化的数据访问层,不提供法律判断或税务咨询。

  • 解释例和决定例是基于个别案件事实关系的判断。

  • 国税厅解释例是税务部门的法令解释,不约束法院。

  • 基本通则和执行标准是内部执行标准,并非法律。

  • 修订法令需另行确认适用时间。

  • 数据的准确性和最新性遵循国税法令信息系统的更新状态。

  • 对于需要法律效力的判断,必须确认国税法令信息系统原文。

  • 实际申报、异议等具有法律效力的行为,需由税务师、律师等具备资格的专业人士审查。


许可证

MIT

数据来源声明请参见NOTICE

Install Server
A
license - permissive license
A
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    A
    quality
    B
    maintenance
    Enables searching and retrieving tax law data from the Korean National Tax Service database, including interpretations, rulings, forms, publications, and site menus via MCP tools.
    14
    1
    MIT
  • A
    license
    -
    quality
    B
    maintenance
    This MCP server enables searching Korean construction standards (KDS/KCS), laws from the Ministry of Government Legislation, administrative rules and interpretations, and optionally local water/wastewater design manuals to generate grounded evidence packages for engineering answers.
    2
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    MCP server providing comprehensive Korean legal data access (laws, precedents, regulations, ordinances) with citation verification, temporal comparison, impact graphs, and legal research workflows.
    10
    4,414
    MIT

View all related MCP servers

Related MCP Connectors

  • Korean public procurement law: rule-engine rulings, statutes search, live court precedents

  • Korean public procurement law: rule-engine rulings, statutes search, live court precedents

  • Read-only MCP server for searching Japan government procurement bid information from the KKJ portal.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/zisu17/nts-taxlaw-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server