korean-tax-calc-mcp — Korea Tax Calculator MCP (한국 세금 계산)
· English
0.3.0부터 Solar Pro 4가 코드를 쓰고 CodeSolar가 리뷰, Claude가 테스트로 교차 검증합니다. 도구 62개, 상세는 CHANGELOG.
Korean tax calculations for AI agents — code, not guesses. English
세금 계산은 AI가 자주 틀립니다. 이 서버는 계산을 코드로 하고, 결과마다 근거 조문을 붙입니다. 연도표가 없는 해는 추정하지 않고 멈춥니다.
작동 방식
flowchart LR
Q["AI의 입력<br/>연도·금액·항목"] --> V["입력 확인<br/>모르는 항목·빠진 값 거부"]
V --> T["그해 기준값<br/>세율·한도·공제율"]
T --> E["계산<br/>조문 순서대로"]
E --> R["결과<br/>세액·세무조정·근거 조문"]
T -.->|표 없는 연도| X["멈춤<br/>추정 계산 안 함"]
- 입력 확인 — 모르는 항목·빠진 값이 있으면 계산하지 않고 무엇이 필요한지 알려 줍니다.
- 그해 기준값 — 세율·한도는 코드 안 연도표(법인세·소득세 2016
2026, 부가세 2016년 1기2026년 2기), 항목별 판단 기준은facts_vocab.json(적용 기간·근거 조문 포함)에서 꺼냅니다. - 계산 — 조문 순서대로 계산합니다. 예: 과세표준 → 그해 세율 구간 → 산출세액.
- 결과 — 세액·중간 계산·항목별 판단·세무조정(소득처분)·근거 조문을 함께 돌려줍니다.
계산·판정 도구 59개는 생성형 AI 없이 내 PC에서 동작합니다. PDF 도구 3개만 UPSTAGE_API_KEY가 있을 때 Upstage를 씁니다.
이렇게 물어보세요
- "2025 사업연도 과세표준 5억 법인세 산출세액은?"
- "가지급금 3월 1일 2억 대여, 9월 30일 1억 회수 — 인정이자 계산해줘"
- "과소신고 1천만 원을 10월 7일에 납부하면 가산세는?"
- "퇴직금 1억, 근속 15년 퇴직소득세"
- "기업업무추진비 원장 5건 그대로 줄게 — 2025 사업연도 세무조정 뽑아줘"
설치
claude mcp add korean-tax-calc -- uvx korean-tax-calc-mcp
{ "mcpServers": { "korean-tax-calc": { "command": "uvx", "args": ["korean-tax-calc-mcp"] } } }
키 없이 동작합니다. 선택: LAW_OC(세무조사 판정 도구 2개의 법제처 조문 조회), UPSTAGE_API_KEY(PDF 표 추출).
근거 조문·해석은 korean-tax-mcp와 함께 쓰면 "근거 찾기 → 계산"이 이어집니다.
도구 (62개)
- 원장 그대로 입력: 세무조정 도구는 장부 항목(이름·금액·증빙·성격)을 그대로 받아 항목 판단 → 세무조정 → 소득처분까지 돌려줍니다.
- 쟁점 표시: 비거주자 원천징수·과소자본 결과에는 다툼이 될 수 있는 지점과 확인할 자료를 함께 붙입니다(결론은 내리지 않음).
- 지원 연도: 법인세 2016
2026 사업연도, 소득세 20162026 귀속연도, 부가가치세 2016년 1기~2026년 2기, 가산세·제척기간은 현행 조문. 그 밖의 연도는 오류로 멈춥니다. 지방소득세는 별도입니다.
면책 및 고지
- 면책: 이 도구의 결과는 세무 자문이 아닙니다. 법령·해석을 바탕으로 계산·판정 과정을 보여 주는 참고 자료이며, 실제 신고·세무조사·불복 판단은 세무사·회계사·변호사 등 전문가에게 확인하세요. 근거 조문·판례는 원문으로 확인하세요.
- 세무대리 아님: 이 도구는 세무사법 제2조의 세무대리(세무조정계산서 작성, 신고 대리, 세무상담 등)를 수행하지 않으며, 그 업무는 세무사와 등록한 공인회계사·변호사만 할 수 있습니다(세무사법 제20조). 법령에 적힌 산식을 코드로 옮겨 입력값에 대한 계산 과정을 보여 주는 소프트웨어이고, 입력 사실관계의 확인과 최종 판단은 세무 전문가(세무사·회계사·변호사)와 함께 해 주세요.
- AI 사용 고지: 계산·판정 도구 59개는 코드로 동작하며 생성형 AI를 쓰지 않습니다. PDF 검토 도구 3개(
extract_relations,tunnelling_from_pdf,return_precheck_pdf)는 UPSTAGE_API_KEY가 있으면 생성형 AI(Upstage Solar Pro 4)로 표를 추출하며 결과에 그 사실을 표시합니다. 키가 없으면 pypdf로 로컬 텍스트 추출(host_ai 모드) 후 정리 안내에 따라 다음 도구 입력으로 직접 정리할 수 있습니다. - 데이터 전송: UPSTAGE_API_KEY를 설정해 PDF 도구를 사용할 때만 문서 내용이 Upstage API(api.upstage.ai)로 전송됩니다. 키 없이 사용하면(pypdf 로컬 추출) 외부 전송이 없습니다. 민감정보가 담긴 문서는 API 전송 시 넣지 마세요.
라이선스
MIT © 2026 Upstage · Created by Mia(윤승미)