nts-taxlaw-mcp
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 |
不支持的数据
数据 | 原因 |
法律·施行令·施行规则正文 | 国家法令信息中心为原件,由 |
税收条约 | 法制处条约API更稳定,因此不重复实现 |
一般判例·宪法法院决定全部 | 仅查询赋予税目的税收案件 |
税法执行标准条款正文 | 原件以年度PDF形式发布,仅提供目录·条款名称·PDF文件ID |
表格文件二进制 | 采用POST表单下载方式,无稳定的GET URL |
审计院审查请求·纳税人保护委员会审议案例·评估审议案例 | 目前未通过单独模块·操作实现 |
出版物·税目摘要信息·术语词典·税务日程 | 非法律依据的指导资料,目前不支持 |
更多调查内容请参考docs/INVESTIGATION.md。
Related MCP server: korean-engineering-mcp
2. 数据来源
所有数据均查询自国税厅国税法令信息系统。
使用公开查询端点
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 |
|
|
B |
|
|
C |
|
|
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-0119similarDocuments是搜索辅助信息,不视为请求的文档。
如果仅存在0119和119等零填充差异,则视为同一文档编号。规范化仅用于扩展查询候选,最终响应中仍返回国税厅原件的文档编号。
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_DTM、FRS_RGT_DTM、SCORE。
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 -emacOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh安装后重新打开终端并确认。
uv --version5.2 服务器安装
可直接从GitHub地址安装。
uv tool install git+<GitHub 주소>安装后,可在任意路径下执行nts-taxlaw-mcp命令。
确认安装位置:
(Get-Command nts-taxlaw-mcp).Sourcewhich nts-taxlaw-mcp常见安装路径:
OS | 路径 |
Windows |
|
macOS / Linux |
|
更新:
uv tool upgrade nts-taxlaw-mcp卸载:
uv tool uninstall nts-taxlaw-mcp5.3 源码安装
如需修改代码或运行测试,请下载仓库使用。
git clone <GitHub 주소>
cd nts-taxlaw-mcp
uv syncuv 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.py5.4 确认PATH
安装后若找不到uv或nts-taxlaw-mcp命令,请重新打开终端后确认。
uv tool update-shell在Windows中使用绝对路径确认:
& "$env:USERPROFILE\.local\bin\uv.exe" --versionmacOS / Linux:
~/.local/bin/uv --version6. 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 listHTTP连接
服务器运行:
nts-taxlaw-mcp --http --port 8000Claude Code注册:
claude mcp add --transport http nts-taxlaw http://127.0.0.1:8000/mcp7. Claude Desktop连接
配置文件:
OS | 路径 |
Windows |
|
macOS |
|
在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).Sourcewhich 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 --helpWindows虚拟环境激活:
.venv\Scripts\activate在Claude Desktop中指定虚拟环境中Python的绝对路径。
{
"mcpServers": {
"nts-taxlaw": {
"command": "/절대경로/nts-taxlaw-mcp/.venv/bin/python",
"args": ["-m", "nts_taxlaw_mcp"]
}
}
}8. 环境变量
所有项均为可选,仅使用默认值即可运行。
变量 | 默认值 | 说明 |
|
| 请求超时(毫秒) |
|
| 重试次数 |
|
| 每分钟请求限制 |
|
| 突发允许量 |
|
| 正文最大字符数 |
|
| 缓存最大条目数 |
| Chrome UA | User-Agent |
9. MCP工具
共提供9个工具。
工具 | 用途 |
| 文档编号精确查询 |
| 税法解释例搜索 |
| 判例·决定例搜索 |
| 解释例·决定例正文查询 |
| 基本通则·执行标准·告示·训令搜索 |
| 通则·执行标准特定条款查询 |
| 法令格式·附表搜索 |
| 全领域综合搜索 |
| 针对税务问题的分层依据收集 |
如果已知文档编号,请优先使用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. 法律依据分类
税务资料根据依据的性质进行分类返回。
值 | 含义 |
| 法律 |
| 施行令 |
| 施行规则 |
| 国税厅解释例·例规 |
| 基本通则·执行标准·告示·训令 |
| 税务是否·异议申请·审查请求·裁决请求 |
| 法院判例·宪法法院决定 |
国税厅例规是税务当局的法律解释,不约束法院。基本通则和执行标准是内部执行标准,并非法律本身。
11. 错误处理
区分资料实际不存在与原始服务器问题导致无法查询的情况。
错误代码 | 含义 | 可判断为不存在 |
| 原件中无匹配资料 | O |
| 文档存在但原件不提供正文 | X |
| 国税厅错误·维护·异常响应 | X |
| 响应格式与预期不符 | X |
| 超过服务器自身请求限制 | X |
| 请求超时 | X |
| 输入错误 | X |
错误响应中包含guardrail信息,以防止模型生成未经确认的正文或结论。
即使HTTP 200响应,如果返回维护页面HTML或正文异常为空,也会视为临时故障并重试。
12. 请求限制及缓存
为避免对国税法令信息系统造成过多请求,限制调用量并减少重复查询。
请求限制
默认请求限制:每分钟60次
突发允许量:最大20次
考虑
tax_research等单次任务中连续多次请求的情况,采用令牌桶方式
缓存
目标 | 保留时间 |
搜索结果 | 30分钟 |
文档正文 | 24小时 |
通则·执行标准·告示·训令 | 12小时 |
法令列表 | 7天 |
重复请求处理
当相同请求同时到达时,仅执行一次实际国税法令信息系统查询,并共享结果。
HTTP连接复用
使用httpx的keep-alive连接池。
13. 免责声明
本服务器是用于国税厅原文搜索和结构化的数据访问层,不提供法律判断或税务咨询。
解释例和决定例是基于个别案件事实关系的判断。
国税厅解释例是税务部门的法令解释,不约束法院。
基本通则和执行标准是内部执行标准,并非法律。
修订法令需另行确认适用时间。
数据的准确性和最新性遵循国税法令信息系统的更新状态。
对于需要法律效力的判断,必须确认国税法令信息系统原文。
实际申报、异议等具有法律效力的行为,需由税务师、律师等具备资格的专业人士审查。
许可证
MIT
数据来源声明请参见NOTICE。
Maintenance
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
- AlicenseAqualityBmaintenanceEnables searching and retrieving tax law data from the Korean National Tax Service database, including interpretations, rulings, forms, publications, and site menus via MCP tools.141MIT
- Alicense-qualityBmaintenanceThis 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.2MIT
- Flicense-qualityBmaintenanceAccess Korea's national tax law information system to search rulings, precedents, statutes, and more using natural language queries via Claude.2
- AlicenseAqualityCmaintenanceMCP server providing comprehensive Korean legal data access (laws, precedents, regulations, ordinances) with citation verification, temporal comparison, impact graphs, and legal research workflows.104,414MIT
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.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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