# korean-taxlaw-mcp

국세·지방세 법령정보시스템의 원문을 직접 조회하는 한국 세법 MCP 서버입니다.

- 국세청 세법해석례·판례·결정례·기본통칙 검색
- 행정안전부 지방세 유권해석과 지방세 심판·판례 검색
- 문서번호로 정확한 문서를 찾아 본문까지 조회
- 출처 URL과 근거 유형을 포함한 구조화 응답

> 법률·시행령·시행규칙 본문은 제공하지 않습니다. 해당 자료는 국가법령정보센터 기반의
> [chrisryugj/korean-law-mcp](https://github.com/chrisryugj/korean-law-mcp)와 함께 쓰는 편이
> 좋습니다.

## 조회 가능한 자료

| 구분 | 출처 | 주요 자료 |
|---|---|---|
| 국세 | [국세법령정보시스템](https://taxlaw.nts.go.kr) | 질의회신, 사전답변, 과세기준자문, 심사·심판·판례, 기본통칙·집행기준·고시·훈령, 서식 |
| 지방세 | [지방세 법령정보시스템](https://www.olta.re.kr) | 행정안전부·법제처 유권해석, 조세심판원·감사원·법원·헌재 결정례 |

취득세·재산세·자동차세 등은 **지방세** 도구를, 양도소득세·법인세·부가가치세 등은
**국세** 도구를 사용합니다.

## 빠른 시작

사용 중인 데스크톱 앱에서 새 대화를 열고 아래 요청문을 붙여 넣으세요. 나머지는 앱에
맡기면 됩니다.

### Claude Desktop에 설치 요청하기

Claude Desktop 대화창에 다음 요청문을 입력합니다.

```text
korean-taxlaw-mcp를 이 컴퓨터에 로컬 MCP로 설치해줘.

현재 사용 중인 Claude Desktop 앱의 로컬 STDIO MCP 서버로 등록하고,
이름은 korean-taxlaw로 지정해줘.

저장소: https://github.com/zisu17/korean-taxlaw-mcp

uv가 없으면 먼저 설치해. 그런 다음 uv tool로 패키지를 설치하고 실행 파일의 절대경로를
찾아 Claude Desktop 설정에 넣어줘. 기존 MCP 설정은 그대로 두고, 끝나면 앱 재시작 방법을
알려준 뒤 연결도 확인해줘.
```

### ChatGPT 데스크톱 앱의 Codex에 설치 요청하기

ChatGPT 데스크톱 앱의 Codex 대화창에 다음 요청문을 입력합니다.

```text
korean-taxlaw-mcp를 이 컴퓨터에 로컬 MCP로 설치해줘.

현재 사용 중인 ChatGPT 데스크톱 앱의 Codex에서 쓸 로컬 STDIO MCP 서버로
등록하고, 이름은 korean-taxlaw로 지정해줘.

저장소: https://github.com/zisu17/korean-taxlaw-mcp

uv가 없으면 먼저 설치해. 그런 다음 uv tool로 패키지를 설치하고 실행 파일의 절대경로를
찾아 ChatGPT 데스크톱 앱의 Codex MCP 설정에 넣어줘. 기존 MCP 설정은 그대로 두고,
끝나면 앱 재시작 방법을 알려준 뒤 연결도 확인해줘.
```

직접 설치하거나 문제를 해결해야 한다면 [설치 가이드](docs/INSTALLATION.md)를 참고하세요.

## 사용 예

MCP가 연결된 대화 창에서 일반 문장으로 요청하면 됩니다.

```text
국세청에서 "공동상속주택" 관련 세법해석례를 찾아줘.

서면-2026-법규재산-0119 전문과 원문 링크를 보여줘.

취득세 신탁 관련 행정안전부 유권해석과 심판례를 찾아줘.

부동산세제과-1794(2026.6.9.)호 회신 내용을 보여줘.
```

문서번호를 알고 있다면 키워드 검색보다 문서번호 조회를 요청하는 것이 빠르고 정확합니다.

## 문서

- [사용 가이드](docs/USAGE.md) — 도구 선택, 문서번호 조회, 응답과 오류 해석
- [설정 가이드](docs/CONFIGURATION.md) — 요청 보호, 캐시, 환경변수
- [설치 가이드](docs/INSTALLATION.md) — 운영체제·클라이언트별 설치와 문제 해결
- [개발 가이드](docs/DEVELOPMENT.md) — 개발 환경과 테스트
- [지원 범위 조사](docs/INVESTIGATION.md) — 원본 시스템 분석과 지원·미지원 데이터

## 알아두기

- 원본 시스템에서 조세 자료로 분류한 문서만 조회합니다.
- 원본이 본문을 제공하지 않는 자료는 메타데이터나 파일 식별자만 반환합니다.
- 이 서버는 원문 검색과 구조화를 위한 도구이며 세무 자문을 제공하지 않습니다. 신고·불복 등
  법적 효과가 있는 판단에는 현행 법령과 원문을 확인하고 전문가의 검토를 받으세요.

## 라이선스

MIT License. 데이터 출처 고지는 [`NOTICE`](NOTICE)를 참고하세요.