Skip to main content
Glama
zisu17
by zisu17

nts-taxlaw-mcp

国税庁 国税法令情報システム(https://taxlaw.nts.go.kr) 原本を直接照会するMCPサーバーです。

PythonとFastMCPで実装しており、法制処ミラー(ntsCgmExpc)を経由せず、国税庁自体の照会エンドポイントを使用します。

  • 最新の税法解釈例の照会

  • 回信・判断・結論などの詳細本文の構造化

  • 文書番号ベースのexact lookup

  • 判例・決定例および行政解釈基準の検索

  • 出典と根拠タイプを含む構造化応答

既存の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・アクセス制御の迂回なし

  • 別途セッション・クッキー・認証キー不要

  • すべての応答に原本追跡情報を含む

{
  "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は、2番目の項目が4桁の年号であるかどうかで区別します。

Exact match原則

정확히 일치
→ 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のように0パディングのみ異なる場合は、同一の文書番号として扱います。正規化は照会候補を拡張するための用途のみに使用し、最終応答には国税庁原本の文書番号をそのまま返します。


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 -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確認

インストール直後にuvまたはnts-taxlaw-mcpコマンドが見つからない場合は、ターミナルを再度開いて確認します。

uv tool update-shell

Windowsで絶対パスで確認:

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

macOS / Linux:

~/.local/bin/uv --version

6. Claude Code接続

uv toolでインストールした場合

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

リクエストタイムアウト(ms)

NTS_RETRIES

3

再試行回数

NTS_RATE_PER_MIN

60

1分あたりのリクエスト上限

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

文書番号exact lookup

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は解釈例と決定例の詳細照会を1つのツールに統合します。国税法令情報システムの詳細照会アクションが文書タイプに関係なく同一であるため、別の詳細照会ツールには分けません。

使用例

文書番号照会:

{
  "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. リクエスト制限およびキャッシュ

国税法令情報システムに過剰なリクエストが発生しないように呼び出し量を制限し、繰り返し照会を減らします。

リクエスト制限

  • 基本リクエスト上限: 1分あたり60回

  • バースト許容量: 最大20回

  • tax_researchのように1つの作業で複数のリクエストが続く場合を考慮し、トークンバケット方式を使用

キャッシュ

対象

保持時間

検索結果

30分

文書本文

24時間

通則・執行基準・告示・訓令

12時間

法令リスト

7日

重複リクエスト処理

同一のリクエストが同時に来た場合、実際の国税法令情報システム照会は1回のみ実行し、結果を共有します。

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