한국 공휴일 MCP

왜 필요한가

LLM은 날짜 산수에 약합니다. 특히 한국 공휴일은 음력 기반 명절(설날·추석·부처님오신날)과 대체공휴일 규칙이 얽혀 있어서, 모델이 그럴듯한 오답을 내기 쉽습니다. 실제로 자주 틀리는 지점들:

• 현충일은 대체공휴일이 없습니다. 2027년 6월 6일은 일요일이지만 6월 7일은 정상 근무일입니다 — 현충일은 국경일이 아니라서 제3조 적용 대상이 아닙니다.
• 설날·추석은 일요일과 겹칠 때만 대체공휴일이 생깁니다. 토요일과 겹쳐도 늘어나지 않습니다.
• 제헌절이 2026년부터 다시 공휴일입니다. 2008년 제외 후 18년 만의 복귀라 학습 데이터에 거의 없습니다.

이 커넥터는 「관공서의 공휴일에 관한 규정」을 코드로 구현해서, 매번 결정적으로 같은 답을 냅니다.

연결 방법

Claude 웹 · 데스크톱 앱

1. 설정 → 커넥터로 이동합니다.
2. 커스텀 커넥터 추가를 누릅니다.
3. 이름에 한국 공휴일, URL에 위 커넥터 URL을 붙여넣습니다.
4. 추가한 뒤 대화창의 도구 메뉴에서 켜면 끝입니다.

인증이 없는 공개 서버라 로그인 단계는 나오지 않습니다. 조직 관리자가 배포하는 경우에는 OAuth를 기대하는 화면이 나올 수 있으니, 개인 커넥터로 추가하세요.

Claude Code

claude mcp add --transport http korea-holiday https://korea-holiday-mcp.vercel.app/api/mcp

직접 설정 파일을 쓸 때

{
  "mcpServers": {
    "korea-holiday": {
      "type": "http",
      "url": "https://korea-holiday-mcp.vercel.app/api/mcp"
    }
  }
}

도구 6개

이렇게 물어보세요

• 2026년 2월 17일 쉬는 날이야?
• 2027년 공휴일 다 알려줘
• 다음 공휴일 언제야?
• 9월 1일부터 10월 15일까지 영업일 며칠?
• 오늘부터 7영업일 뒤가 며칠이야?
• 2027년 3일 이상 연휴 정리해줘

데이터 근거와 한계

• 근거 법령: 「관공서의 공휴일에 관한 규정」 제2조(공휴일)· 제3조(대체공휴일). 음력 환산은 korean-lunar-calendar 라이브러리를 씁니다.
• 조회 범위: 2015~2050년. 음력 데이터가 2050년까지만 있어서 그 이후는 계산하지 않고 오류를 냅니다.
• 임시공휴일·선거일은 규칙으로 예측할 수 없어 확정·공포된 것만 수동 등재합니다. 새로 지정되면 저장소에 한 줄 추가하면 됩니다.
• 근로자의 날(5월 1일)은 관공서 공휴일이 아니라 기본값에서는 영업일로 계산합니다. 사기업 기준이 필요하면 Claude에게 “근로자의 날도 휴일로 계산해줘”라고 말하면 됩니다.
• 회사별 창립기념일, 업종별 휴무는 포함하지 않습니다.

중요한 의사결정에는 관보나 인사혁신처 공고로 한 번 더 확인하세요. 계산 결과에 이상이 있으면 이슈로 알려주시면 고칩니다.