korea tax law mcp

CommunityIncomplete39/100Claim

streamable-httpMITupdated 7d ago

한국 세법 그래프 DB를 AI에 연결하는 공개 MCP(Model Context Protocol) 서버입니다. 단순 법 조문을 찾는 것을 넘어, 유권해석 본문, 예규판례 찾는 데 탁월한 DB입니다.

What can you do with korea tax law mcp?

korea-tax-law MCP 서버

국세·지방세 현행 조문(법률·시행령·시행규칙 60개), 판례·조세심판원 결정례 15만+건, 국세청·법제처·행정안전부 해석례 14.8만+건, 107개국 조세조약 조문 3천+개가 그래프로 연결되어 있고, 조문마다 시행일과 개정 연혁이 붙어 있습니다. AI가 세법을 "기억"이 아니라 현행 원문 조회로 답하게 만듭니다.

국가법령정보센터에서 직접 API로 호출하는 것이 아니라, Graph DB로 세법 DB를 다시 설계하여 AI로 하여금 법률 추론의 효과성/효율성을 극대화할 수 있도록 한 DB입니다.

https://mcp.taxjarvis.com/mcp

왜 필요한가

프론티어 모델이 급진적으로 발달했음에도 불구하고 LLM은 세법 질문에 자주 유권해석, 판례 등을 지어내서 답합니다. 또한, 일반 Web 검색을 통한 AI 답변은 학습 시점 이후 개정을 모르고, 세율·한도 숫자를 섞고, 폐지된 조문을 인용합니다. 이 서버를 연결하면 AI가 답하기 전에 현행 시행 버전 조문 원문을 직접 확인합니다.

도구

현재 버전 v0.5.0 (CHANGELOG)

도구	용도
`list_laws`	수록 현행 법령 목록 + 시행일 (국세·지방세 구분)
`search_articles`	조문 전문검색 (복합어 부분일치 폴백 포함)
`get_article`	조문 현행 원문 전체 + 시행일 + 위임 하위법령 조문
`get_article_history`	조문 개정 연혁 ("언제 바뀌었나")
`search_cases`	판례·조세심판원 결정례 검색
`search_interpretations`	국세청·법제처·행정안전부 해석례 검색
`search_annexes`	별표·서식 검색 (세율표·기준금액·분류표)
`get_annex`	별표 본문 전체 + 원본 HWP·PDF 링크
`list_upcoming`	공포됐으나 시행 전인 개정 조문
`list_treaties`	조세조약 체결국 목록 / 국가별 협약·의정서 이력
`search_treaties`	조세조약 조문 전문검색 (제한세율·고정사업장 등)
`get_treaty_article`	조세조약 조문 원문 (국문 + 영문) + 그 조문을 개정한 의정서

연결 방법

Claude (웹/데스크톱): 설정 → Connectors → Add custom connector → https://mcp.taxjarvis.com/mcp

Claude Code:

claude mcp add --transport http korea-tax-law https://mcp.taxjarvis.com/mcp

Codex CLI (~/.codex/config.toml):

[mcp_servers.korea-tax-law]
url = "https://mcp.taxjarvis.com/mcp"

Gemini CLI (~/.gemini/settings.json):

{"mcpServers": {"korea-tax-law": {"httpUrl": "https://mcp.taxjarvis.com/mcp"}}}

구형 SSE 전용 클라이언트: https://mcp.taxjarvis.com/sse stdio 전용 클라이언트: npx -y mcp-remote https://mcp.taxjarvis.com/mcp

수록 범위

법령 — 현행 60건 (법률 22 · 시행령 21 · 시행규칙 17)

표의 날짜는 수록된 버전의 시행일입니다. —는 해당 하위법령이 없거나 아직 미수록이라는 뜻이고, 최신 목록은 언제나 list_laws가 정본입니다.

국세 (17개 세목 · 45건)

세목	법률	시행령	시행규칙
개별소비세법	2026.04.24	2026.07.30	2026.04.01
교육세법	2026.01.01	2026.02.27	—
교통ㆍ에너지ㆍ환경세법	2026.01.02	2026.07.30	2025.04.01
국세기본법	2026.08.11	2026.07.01	2026.03.20
국세징수법	2026.06.02	2026.02.27	—
국제조세조정에 관한 법률	2026.01.02	2026.02.27	2026.03.20
농어촌특별세법	2026.05.12	2026.01.02	—
법인세법	2026.07.01	2026.02.27	2026.07.01
부가가치세법	2026.01.02	2026.04.01	2026.04.01
상속세 및 증여세법	2026.01.02	2026.02.27	2026.03.20
소득세법	2026.07.01	2026.07.01	2026.07.01
인지세법	2026.01.02	2026.01.02	2026.01.02
조세범 처벌법	2021.01.01	—	—
조세범 처벌절차법	2023.01.17	2026.02.27	—
종합부동산세법	2026.01.01	2026.02.27	2026.03.20
주세법	2025.01.01	2026.04.01	2026.01.02
증권거래세법	2022.07.01	2026.01.02	2026.03.20

지방세 (4개 세목 · 12건)

세목	법률	시행령	시행규칙
지방세기본법	2026.02.05	2026.07.01	2026.07.01
지방세법	2026.07.01	2026.07.01	2026.07.01
지방세징수법	2026.02.05	2026.02.05	2026.07.01
지방세특례제한법	2026.06.02	2026.07.01	2026.01.01

공통 (1개 세목 · 3건)

세목	법률	시행령	시행규칙
조세특례제한법	2026.07.01	2026.07.01	2026.07.01

조문 6,686개에 개정 연혁 19,909버전 · 개정 이력 2,529건이 붙어 있습니다.

별표·서식 — 2,144건

세율표·기준금액·분류표는 조문이 아니라 별표에 있는 경우가 많습니다. 조문만 읽으면 "별표에 따른다"에서 막히므로 별표 본문을 함께 싣습니다. 37개 법령에 붙어 있고, 별표제목의 (제9조제1항제1호 관련)을 읽어 해당 조문에 연결한 것이 103건입니다. get_article이 그 조문의 별표를 함께 표시합니다.

시행예정 개정 — 25개 버전 · 조문 123건

공포됐으나 아직 시행되지 않은 개정문입니다. 현행 조문과 분리해서 담습니다 — 섞으면 어느 쪽을 답한 것인지 알 수 없게 됩니다. 현행 조문과 이어진 것이 106건이고, get_article은 그 조문에 시행예정 개정이 있으면 시행일과 함께 경고합니다.

판례·결정례 — 153,009건

구분	건수
조세심판원 결정례	139,504
대법원 판례	8,933
고등법원 판례	3,673
헌법재판소 결정	899

해석례 — 148,524건

발신 기관	건수
국세청 질의회신	136,500 (기관 미표기 6,286 포함)
법제처 법령해석례	8,708
행정안전부 (지방세)	3,316

조세조약 — 107개국 148건

협약·개정의정서·교환각서를 합친 건수이며, 조문 3,002개가 국문·영문 병존으로 들어 있습니다. 그중 220건은 부속문서(개정의정서·교환각서·최혜국대우 통보·전문)이고, 이 부속문서들이 자기가 고치는 조문에 AMENDS 관계로 연결돼 있습니다 — 28개국 104개 조문, 링크 110개. 판례 1,330건·해석례 1,439건도 조약 노드와 연결됩니다.

이 밖에 행정규칙(훈령·예규·고시) 23,987건이 적재돼 있으나 현재 MCP 도구로는 노출하지 않습니다.

수집 출처

전부 공공 원천입니다. 법령·판례는 저작권법 제7조 비보호저작물입니다.

데이터	원천	경로
법령 조문·시행일·개정 연혁	국가법령정보센터 OpenAPI	`lawSearch/lawService.do?target=eflaw` (시행일 법령), `target=law`
별표·서식 본문	국가법령정보센터	법령 상세 XML의 `<별표단위>` (별도 `target=licbyl`이 아님)
시행예정 개정	국가법령정보센터	`target=eflaw` 목록의 현행연혁코드 `시행예정`
대법원·고등법원 판례	국가법령정보센터	`law.go.kr/판례/{id}`
헌법재판소 결정	국가법령정보센터	`target=detc`
조세심판원 결정례	국가법령정보센터	`target=ttSpecialDecc`
국세청 질의회신 목록	공공데이터포털	법제처_국세청 법령해석 목록
국세청 질의회신 본문	국세법령정보시스템	`taxlaw.nts.go.kr` 공개 조회 액션
법제처 법령해석례	국가법령정보센터	`law.go.kr/법령해석례/{id}`
행정안전부 지방세 해석	국가법령정보센터	`target=moisCgmExpc`
행정규칙(훈령·예규·고시)	국가법령정보센터	`target=admrul`
조세조약 메타데이터	국가법령정보센터	`target=trty`
조세조약 조문 본문	국세법령정보시스템	`taxlaw.nts.go.kr` 조세조약 메뉴

갱신은 매일 아침 증분 수집(법령 개정·신규 판례·해석례)이며, 수록 범위는 list_laws· list_treaties로 확인합니다. 미수록 법령은 국가법령정보센터 참조.

별표 본문은 별표 API가 아니라 법령 상세 XML에서 옵니다.

별표 상세 엔드포인트(target=licbyl)는 JS 껍데기만 주고 본문을 주지 않습니다. 본문은 법령 상세 XML 안의 <별표단위>에 들어 있어서, 별표만 따로 받는 경로로는 내용이 비어 옵니다.

조세조약 — 개정의정서가 본문에 반영돼 있지 않습니다. 대신 연결해 뒀습니다.

조약은 메타데이터(국가법령정보센터)와 조문 본문(국세법령정보시스템)을 서로 다른 원천에서 받아 합칩니다. 국세법령정보시스템이 주는 조문 본문은 협약 원문이라 이후 개정의정서가 반영돼 있지 않습니다. 스위스 제10조(배당)는 1980년 협약 그대로 10%/15%인데, 2012년 의정서가 이를 5%(지분 10% 이상)/15%로 바꿨습니다.

다행히 그 개정의정서 본문 자체는 부속문서로 함께 들어옵니다. 그래서 수집 단계에서 부속문서 본문의 협약 제N조 참조를 뽑아 해당 조문에 잇습니다. 조문 번호 없이 세율만 알리는 최혜국대우 통보는 소득 유형(배당·이자·사용료)을 조문 제목에 맞춥니다.

이제 get_treaty_article이 조문 본문과 함께 그 조문을 고친 의정서를 발췌까지 붙여 돌려줍니다.

## ⚠ 이 조문을 개정한 부속문서 1건
위 본문은 국세법령정보시스템이 주는 협약 원문이라 아래 개정이 반영돼 있지 않다.
- 개정 의정서(2012.07.25.) (발효 2012.07.25)
  발췌: 협약 제10조(배당) 제2항 세항 가)를 삭제하고, 다음과 같이 대체한다.
        "가) … 자본의 최소 10퍼센트를 직접적으로 소유하는 경우에는 배당총액의 5퍼센트"
  전문: get_treaty_article(country="스위스", article_number="개정 의정서(2012.07.25.)")

list_treaties(country)는 그 나라의 부속문서 목록을, get_treaty_article은 부속문서 제목으로도 전문을 돌려줍니다.

남은 한계: 개정 성격 부속문서 40건 중 35건에서 조문 참조를 뽑았습니다. 나머지와, 애초에 국세법령정보시스템이 부속문서를 싣지 않은 조약은 연결이 없습니다. 그 경우 국가 단위 경고 (후속 협약·의정서 N건 존재)만 표시되니, 제한세율처럼 숫자가 결론을 좌우하는 쟁점은 law.go.kr 원문을 반드시 대조하세요.

직접 호스팅

server.py 하나가 전부입니다. 파이썬 3.9+ 표준 라이브러리만 사용 (의존성 0).

NEO4J_HTTP=http://127.0.0.1:7474 NEO4J_USER=neo4j NEO4J_PASSWORD=... PORT=8788 python3 server.py

단, 같은 스키마의 Neo4j 그래프 DB가 필요합니다 (Law/Article/Case/Interpretation/Treaty/TreatyArticle 노드 + 풀텍스트 인덱스). 데이터 수집 파이프라인은 이 리포에 포함되어 있지 않으므로, 일반 사용자는 호스팅 엔드포인트 사용을 권장합니다.

기본 방어 설정: IP당 분당 30회, 동시 쿼리 4개, 쿼리 타임아웃 8초, read-only.

주의

제공 정보는 실무 참고용이며 공식 유권해석이 아닙니다. 구체적 사안은 반드시 원문(국가법령정보센터·국세법령정보시스템)을 확인하고 전문가와 상의하세요.

만든 사람

박민수 — 한국공인회계사(KICPA), 안세회계법인 세무 이야기: Threads @mangopeach.cpa

Install

Add korea tax law mcp to your client. Pick the one you use.

claude mcp add --transport http korea-tax-law-mcp https://mcp.taxjarvis.com/mcp

codex mcp add korea-tax-law-mcp --url https://mcp.taxjarvis.com/mcp

{
  "mcpServers": {
    "korea-tax-law-mcp": {
      "url": "https://mcp.taxjarvis.com/mcp"
    }
  }
}

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

{
  "servers": {
    "korea-tax-law-mcp": {
      "type": "http",
      "url": "https://mcp.taxjarvis.com/mcp"
    }
  }
}

Add to `.vscode/mcp.json` in your workspace.

{
  "mcpServers": {
    "korea-tax-law-mcp": {
      "url": "https://mcp.taxjarvis.com/mcp"
    }
  }
}

Add to `claude_desktop_config.json`, then restart Claude Desktop.

{
  "mcpServers": {
    "korea-tax-law-mcp": {
      "serverUrl": "https://mcp.taxjarvis.com/mcp"
    }
  }
}

Add to `~/.codeium/windsurf/mcp_config.json`.