Korea Tax Law MCP Server

korea-tax-law MCP 서버

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

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

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

https://mcp.taxjarvis.com/mcp

왜 필요한가

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

도구

현재 버전 v0.4.0 (CHANGELOG)

연결 방법

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건)

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

공통 (1개 세목 · 3건)

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

판례·결정례 — 153,009건

해석례 — 148,524건

조세조약 — 107개국 148건

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

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

수집 출처

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

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

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

조약은 메타데이터(국가법령정보센터)와 조문 본문(국세법령정보시스템)을 서로 다른 원천에서 받아 합칩니다. 국세법령정보시스템이 주는 조문 본문은 협약 원문이라 이후 개정의정서가 반영돼 있지 않습니다. 스위스 제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