loading…
by kim-go-chonSearch for a command to run...
loading…
Enables searching and retrieving tax law data from the Korean National Tax Service database, including interpretations, rulings, forms, publications, and site m
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.
국세법령정보시스템(https://taxlaw.nts.go.kr) 자료를 MCP 도구로 검색하는 STDIO 서버입니다.
MCP 1.27 TypeScript License: MIT
법제처에서 바로 찾기 어려운 국세청 세법해석, 질의회신, 조세 불복 문서, 기본통칙, 별표/서식, 발간책자, 홈택스 상담사례를 보완 검색합니다.
전용 고수준 도구가 아직 없는 메뉴도 접근할 수 있도록, 확인된 사이트 메뉴/action 목록 조회와 action.do 원시 호출, 같은 사이트 HTML 텍스트 조회 도구를 함께 제공합니다.
세법 질의는 먼저 korean-law-mcp로 법령 조문, 시행령, 판례, 조세심판 등 법제처/법령 DB 자료를 확인하고, 법제처 검색에서 국세청 질의회신·기본통칙·홈택스 상담사례·발간책자를 찾지 못할 때 이 서버로 보완 조회하는 흐름을 권장합니다.
두 MCP가 같은 판례·결정례·해석례를 찾으면 문서번호/청구번호/사건번호에서 공백·하이픈을 제거한 값, 생산일자/의결일자, 제목을 기준으로 하나로 정리하세요. 같은 항목은 중복 나열하지 말고 양쪽 출처 ID를 함께 남기며, 국세법령정보시스템에만 있는 원문 스니펫·홈택스 상담·기본통칙·발간책자는 이 서버 결과로 보완합니다.
이 서버는 국세법령정보시스템 응답에 존재한 항목만 표시하며, 검색 실패나 외부 사이트 오류가 나면 [NOT_FOUND], [EXTERNAL_API_ERROR], [INVALID_PARAMETER] 같은 마커와 추측 금지 경고를 반환합니다.
MCP InitializeResult.instructions로 LLM에 자동 주입됩니다. 클라이언트(Claude Code 등)는 이를 system-reminder로 노출하여 LLM이 아래 5단 구조를 따르도록 강제합니다. 단순 1~2문장 단답형 질문은 생략 가능.
korean-law-mcp.get_law_text 결과list/get_taxlaw_basic_ruling 또는 본문 인용출처 격리 — (1)~(4)는 검증된 출처. 섹션 내용을 다른 섹션과 섞지 말 것. AI 보충과의 혼합 금지.
연도 검증 의무 — 해석례 인용 시 get_taxlaw_document_text(targetYear=YYYY)로 인용 법조문 시점 자동 검증. 구법조문 기반 예규는 ⚠ 사문화 가능성 경고 동봉.
사문화 자동 채점 (0.7.0+) — 예규/심판례/판례를 인용할 때 assess_doctrine_validity(id, targetYear)를 호출하면 8단계 분류(valid_current / target_or_later / before_target / partially_outdated / repealed_or_superseded / no_citations / no_target / uncertain)와 6단계 최종 판정(valid_current / needs_current_check / partially_outdated / likely_outdated / superseded_or_repealed / unverified)을 자동 채점하고, korean-law-mcp로 현행 조문 대조 + 후속 결정(대법원·헌재) 확인까지 이어지는 next-action 큐를 반환합니다.
| Tool | 용도 |
|---|---|
search_taxlaw_all |
국세법령정보시스템 통합검색. 별표서식, 국세법령, 세법해석/질의, 판례·결정례, 발간책자, 홈택스 상담사례를 함께 검색 |
search_taxlaw_documents |
세법해석례/질의회신과 과세전적부, 이의, 심사, 심판, 판례, 헌재 문서 검색 |
get_taxlaw_document_text |
검색 결과의 DOC_ID/DOCID로 문서 상세 본문 조회. targetYear 옵션으로 인용 법조문 시점 자동 검증 |
assess_doctrine_validity (0.7.0) |
단일 예규·심판례·판례의 현행 유효성 자동 채점. 시점 비교 + 사문화 신호 + 최종 판정 6단계 + 권장 후속 호출 큐(korean-law-mcp.search_law/get_law_text/search_decisions + NTS 후일자 해석례 검색) 반환 |
get_taxlaw_hometax_counsel_text |
통합검색 홈택스 상담사례 결과의 REQ_STD_ID로 상세 본문 조회 |
list_taxlaw_site_menus |
국세법령정보시스템 주요 메뉴와 확인된 action.do 호출 정보 조회 |
call_taxlaw_action |
메뉴에서 확인한 actionId/paramData로 action.do 원시 JSON 조회 |
get_taxlaw_page_text |
정적 HTML 자료와 일반 페이지를 텍스트로 조회 |
search_taxlaw_interpretations |
기존 호환용 세법해석례 검색 alias |
get_taxlaw_interpretation_text |
기존 호환용 세법해석례 상세 alias |
list_taxlaw_basic_ruling_laws |
기본통칙 법령 목록 조회 |
get_taxlaw_basic_ruling_text |
기본통칙 본문 조회 |
search_taxlaw_forms |
전체 서식, 별표, 법령서식, 훈령서식, 자주찾는서식 검색 |
search_taxlaw_publications |
국세청 발간책자 검색. 가능한 경우 상세 API의 파일 ID와 다운로드 힌트까지 표시 |
list_taxlaw_publication_categories |
발간책자 분야 코드 조회 |
국세청 「업종코드-표준산업분류 연계표」를 빌드 시 JSON으로 변환해 내장. 분류수준 자동 식별로 LLM이 "대분류만 보고 잘못 매칭"하는 실수를 차단합니다.
| Tool | 용도 |
|---|---|
lookup_upjong_code |
6자리 업종코드 → 5단계 분류(대/중/소/세/세세) + KSIC 매핑 |
lookup_ksic_code |
KSIC 5자리 정확 일치 → 매핑된 업종코드 |
lookup_ksic_prefix (0.5.0) |
KSIC prefix 매칭. 영문 1자리(B/C/M…)=대분류, 2 |
search_industry_by_keyword |
분류명 키워드 검색. levels 옵션으로 검색 분류수준 한정 |
resolve_industry_class |
산업명 → KSIC/업종 분류수준 후보. levels 옵션 |
classify_industry_for_article |
법조문 산업명·제외 단서·업종코드 → verdict ∈ {match, excluded, out_of_scope, ambiguous}. excludeLevels 옵션 |
upjong_db_info |
내장 DB 신선도(귀속연도·생성시각·레코드 수) |
classify_industry_for_article({
industryName: "기타 전문, 과학 및 기술 서비스업",
upjongCode: "749942", // 중분류 74 "전문 서비스업"
excludeNames: ["수의업"]
})
// → verdict: out_of_scope (16호가 가리키는 KSIC 중분류 73과 일치하지 않음)
먼저 list_taxlaw_site_menus로 메뉴 키, URL, 확인된 actionId, 기본 paramData를 확인합니다. 전용 도구가 있는 메뉴는 해당 고수준 도구를 쓰고, 없는 메뉴는 call_taxlaw_action에 actionId, defaultParamData, refererPath를 넘겨 원시 응답을 조회합니다. 세목별요약정보·세법개정건의처럼 정적 HTML로 제공되는 자료는 get_taxlaw_page_text에 /html/U_0101.html, /cm/USECMJ001M.do 같은 경로를 넘겨 조회합니다. 세무일정은 list_taxlaw_site_menus(query="세무일정")에서 확인한 ASECMC001MR01 action에 year, month를 넘겨 조회할 수 있습니다.
git clone https://github.com/kim-go-chon/taxlaw-nts-mcp.git
cd taxlaw-nts-mcp
npm install
npm run build # tsc + 내장 DB(JSON) 복사
npm test # 57개 단위 테스트 (선택)
npm start # MCP STDIO 서버 실행
설치 후 추가 다운로드 없이 모든 도구가 즉시 동작합니다. 업종코드↔KSIC 매핑 DB(src/data/upjong-ksic.json, 약 1.5MB, 1,784 레코드, 귀속연도 2024)는 저장소에 포함되어 있습니다.
국세청이 「업종코드-표준산업분류 연계표」를 갱신했을 때만 필요합니다. 본인이 받은 최신 CSV를 환경변수로 지정해 재빌드하면 됩니다.
# Linux/macOS
UPJONG_CSV=/path/to/업종코드-표준산업분류\ 연계표.csv npm run build:data
# Windows PowerShell
$env:UPJONG_CSV = "C:\path\to\업종코드-표준산업분류 연계표.csv"
npm run build:data
# 그 다음 (두 OS 공통)
npm run build
claude_desktop_config.json(Claude Desktop) 또는 프로젝트별 .mcp.json(Claude Code)에 등록:
{
"mcpServers": {
"taxlaw-nts": {
"command": "node",
"args": ["/absolute/path/to/taxlaw-nts-mcp/build/index.js"]
}
}
}
현재 본 MCP는 claude.ai 웹에서 직접 사용할 수 없습니다. claude.ai의 Custom Connectors 기능은 공인 인터넷으로 노출된 원격 MCP 서버(HTTPS)만 지원하지만, 본 서버는 STDIO 전용입니다.
권장 대안 — Claude Desktop: 위 "Claude Code" 섹션의 claude_desktop_config.json 등록 방식이 그대로 적용됩니다. Claude Desktop은 macOS/Windows 앱에서 로컬 STDIO MCP를 직접 지원하므로 별도 배포 없이 즉시 동작합니다. claude.ai 웹과 동일한 모델·대화 히스토리를 사용하면서 본 MCP를 쓰려면 Claude Desktop이 가장 간단한 경로입니다.
~/.codex/config.toml에 등록:
[mcp_servers.taxlaw-nts]
command = "node"
args = ["/absolute/path/to/taxlaw-nts-mcp/build/index.js"]
default_tools_approval_mode = "approve"
Windows 사용자는 백슬래시 경로 + node.exe 절대경로 권장:
[mcp_servers.taxlaw-nts]
command = 'C:\Program Files\nodejs\node.exe'
args = ['C:\Users\사용자명\.codex\mcp\taxlaw-nts-mcp\build\index.js']
default_tools_approval_mode = "approve"
cd /path/to/taxlaw-nts-mcp
git pull
npm install
npm run build # CSV가 등록되어 있으면 데이터도 함께 재빌드
MCP 클라이언트(Claude Code, Codex)를 재시작하면 새 버전이 활성화됩니다.
npm 레지스트리에 배포된 경우 더 짧게 등록 가능합니다.
npm install -g taxlaw-nts-mcp
{ "mcpServers": { "taxlaw-nts": { "command": "taxlaw-nts-mcp" } } }
[mcp_servers.taxlaw-nts]
command = "taxlaw-nts-mcp"
API 키는 필요하지 않습니다. 기본 User-Agent는 taxlaw-nts-mcp/<version> (+https://github.com/kim-go-chon/taxlaw-nts-mcp)로 클라이언트 식별이 가능하게 설정되어 있습니다. 국세법령정보시스템에서 봇으로 차단되는 경우에 한해 일반 브라우저 UA로 덮어쓰세요.
TAXLAW_USER_AGENT="Mozilla/5.0 ..."
검색 또는 상세 조회 결과가 없으면 [NOT_FOUND]와 isError: true를 반환합니다. 외부 사이트 오류는 [EXTERNAL_API_ERROR], 잘못된 입력은 [INVALID_PARAMETER]로 반환합니다. 결과 본문에는 출처 URL과 실제 조회한 ID를 함께 표시합니다.
npm run build
npm run watch
npm test
npm pack --dry-run
https://taxlaw.nts.go.kr)의 공개 자료입니다. 저작권은 각 발행기관(국세청·법원·헌법재판소·기재부 등)에 있습니다.src/data/upjong-ksic.json, 귀속연도 2024)를 포함합니다. 사용자가 추가로 다운로드할 필요 없이 즉시 사용 가능합니다. 최신 데이터로 교체하려면 본인이 받은 CSV를 UPJONG_CSV 환경변수로 지정해 npm run build:data && npm run build를 다시 실행하세요.이 도구는 국세법령정보시스템(https://taxlaw.nts.go.kr)의 공개 자료를 개인 학습·연구·법률 업무 보조 목적으로 조회하기 위한 비공식 클라이언트입니다. 이 프로젝트는 국세청과 무관하며, 사용자가 직접 NTS의 이용약관과 법령을 준수할 책임이 있습니다.
robots.txt를 사용 전 확인하세요.MIT
Run in your terminal:
claude mcp add taxlaw-nts-mcp -- npx Yes, Taxlaw Nts MCP is free — one-click install via Unyly at no cost.
No, Taxlaw Nts runs without API keys or environment variables.
A hosted option is available: Unyly runs the server in the cloud, no local setup required.
Open Taxlaw Nts on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
CSA PROJECT - FZCO © 2026 IFZA Business Park, DDP, Premises Number 31174 - 001
Security
Low riskAutomated heuristic from public metadata — not a security guarantee.
