nts-taxlaw-mcp
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 |
サポートしないデータ
データ | 理由 |
法律・施行令・施行規則の本文 | 国家法令情報センターが原本であり、 |
租税条約 | 法制処の条約APIがより安定しているため、重複実装しない |
一般判例・憲裁決定全体 | 税目が付与された租税事件のみ照会 |
税法執行基準の条項本文 | 原本が年度別PDFで配布されており、目次・条項名・PDFファイルIDまでのみ提供 |
書式ファイルバイナリ | POSTフォームダウンロード方式で安定したGET URLがない |
監査院審査請求・納税者保護委員会審議事例・評価審議事例 | 別途モジュール・アクションで現在未実装 |
発刊冊子・税目別要約情報・用語辞典・税務日程 | 法的根拠ではない案内資料として現在サポートしない |
追加調査内容はdocs/INVESTIGATION.mdを参照してください。
Related MCP server: korean-engineering-mcp
2. データ出典
すべてのデータは国税庁国税法令情報システムから照会します。
公開照会エンドポイント
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 |
|
|
B |
|
|
C |
|
|
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-0119similarDocumentsは検索補助情報であり、要求した文書とは見なされません。
0119と119のように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 -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-shellWindowsで絶対パスで確認:
& "$env:USERPROFILE\.local\bin\uv.exe" --versionmacOS / Linux:
~/.local/bin/uv --version6. 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 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-mcpkorean-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\activateClaude Desktopには仮想環境のPython絶対パスを指定します。
{
"mcpServers": {
"nts-taxlaw": {
"command": "/절대경로/nts-taxlaw-mcp/.venv/bin/python",
"args": ["-m", "nts_taxlaw_mcp"]
}
}
}8. 環境変数
すべての項目はオプションであり、デフォルト値のみで実行できます。
変数 | デフォルト値 | 説明 |
|
| リクエストタイムアウト(ms) |
|
| 再試行回数 |
|
| 1分あたりのリクエスト上限 |
|
| バースト許容量 |
|
| 本文最大文字数 |
|
| キャッシュ最大項目数 |
| Chrome UA | User-Agent |
9. MCPツール
合計9つのツールを提供します。
ツール | 用途 |
| 文書番号exact lookup |
| 税法解釈例検索 |
| 判例・決定例検索 |
| 解釈例・決定例本文照会 |
| 基本通則・執行基準・告示・訓令検索 |
| 通則・執行基準の特定条項照会 |
| 法令書式・別表検索 |
| 全領域統合検索 |
| 税務質疑に対する層別根拠収集 |
文書番号が分かっている場合は、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. 法的根拠の区分
税務資料は根拠の性質に応じて区分して返します。
値 | 意味 |
| 法律 |
| 施行令 |
| 施行規則 |
| 国税庁解釈例・例規 |
| 基本通則・執行基準・告示・訓令 |
| 課税適否・異議申立・審査請求・審判請求 |
| 裁判所判例・憲裁決定 |
国税庁の例規は課税官庁の法令解釈であり、裁判所を拘束しません。基本通則と執行基準は内部の執行基準であり、法規自体ではありません。
11. エラー処理
資料が実際に存在しない場合と、原本サーバーの問題で照会できない場合を区別します。
エラーコード | 意味 | 不存在と判断可能 |
| 原本に一致する資料がない | O |
| 文書はあるが原本で本文を提供しない | X |
| 国税庁エラー・点検・異常応答 | X |
| 応答形式が予想と異なる | X |
| サーバー自体のリクエスト上限超過 | X |
| リクエスト時間超過 | X |
| 入力エラー | X |
エラー応答には、モデルが未確認の本文や結論を生成しないようにguardrail情報を一緒に返します。
HTTP 200応答でも点検ページHTMLが返されたり、本文が異常に空の場合は一時障害として処理し、再試行します。
12. リクエスト制限およびキャッシュ
国税法令情報システムに過剰なリクエストが発生しないように呼び出し量を制限し、繰り返し照会を減らします。
リクエスト制限
基本リクエスト上限: 1分あたり60回
バースト許容量: 最大20回
tax_researchのように1つの作業で複数のリクエストが続く場合を考慮し、トークンバケット方式を使用
キャッシュ
対象 | 保持時間 |
検索結果 | 30分 |
文書本文 | 24時間 |
通則・執行基準・告示・訓令 | 12時間 |
法令リスト | 7日 |
重複リクエスト処理
同一のリクエストが同時に来た場合、実際の国税法令情報システム照会は1回のみ実行し、結果を共有します。
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