韓国祝日 MCP

コネクタURL: https://korea-holiday-mcp.vercel.app/api/mcp 紹介ページ: https://korea-holiday-mcp.vercel.app

ClaudeにURLを1つ登録するだけで、韓国の祝日・代替休日・営業日計算を正確に処理するMCPサーバーです。 認証のない公開コネクタなので、インストール・ログイン・APIキーは不要です。

なぜ必要なのか

LLMは日付の計算が苦手です。韓国の祝日は旧暦の祝日(旧正月・秋夕・釈迦誕生日)と代替休日ルールが 絡み合っているため、モデルがもっともらしい誤答を出しやすいのです。実際によく間違えるポイント:

• 顕忠日に代替休日はありません。 2027年6月6日は日曜日ですが、6月7日は通常の勤務日です。 顕忠日は国慶日ではないため、「官公署の休日に関する規定」第3条の適用対象ではありません。

• 旧正月・秋夕は日曜日と重なる場合のみ代替休日が発生します。土曜日と重なっても増えません。

• 制憲節が2026年から再び祝日になります。2008年に除外されてから18年ぶりの復帰なので、学習データにはほとんどありません。

このサーバーは日付表を暗記しているのではなく、法令をコードで実装しているため、毎回決定的に同じ答えを返します。

接続方法

Claude Web・デスクトップアプリ

1. 設定 → コネクタに移動

2. カスタムコネクタ追加をクリック

3. 名前韓国祝日、URLにhttps://korea-holiday-mcp.vercel.app/api/mcpを入力

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"
    }
  }
}

ツール

共通オプション:

• includeLaborDay (デフォルトfalse) — 労働者の日(5/1)を休日として計算するか。 労働者の日は官公署の祝日ではなく、勤労基準法上の有給休暇のため、デフォルトでは営業日とみなします。

• saturdayIsBusinessDay (デフォルトfalse) — 土曜日を営業日として計算するか。

データの根拠と限界

根拠法令: 「官公署の休日に関する規定」第2条(祝日)・第3条(代替休日)

代替休日ルールは施行日を反映して、年ごとに異なる形で適用されます。

照会範囲: 2015~2050年。旧暦データが2050年までしかないため、それ以降はエラーを返します。

含まれないもの

• 会社ごとの創立記念日、業種別の休業日

• 確定していない将来の臨時祝日・選挙日

臨時祝日と選挙日はルールで予測できないため、確定・公布されたものだけをlib/overrides.tsに 手動で登録します。新たに指定されたら1行追加してnpm run verifyを実行すればOKです。

民間カレンダーサイトと異なる可能性がある点

一部の祝日まとめサイトは、2027年6月6日(日)の顕忠日について6月7日を代替休日として表示します。 このサーバーは法令に従って代替休日なしと計算します。2021年の人事革新処の改正当時、代替休日の 対象から元日・顕忠日が明示的に除外され、その後2023年の改正で追加されたのは釈迦誕生日と クリスマスだけです。実際に2021年6月6日(日)にも代替休日はありませんでした。

重要な意思決定には官報や人事革新処の公告で一度確認してください。 計算結果に異常があればイシューでお知らせください。

検証

ルールエンジンの結果を公開資料(2024~2027年)と照合します。

npm run verify

タイムゾーンに関係なく同じ結果が出るかも確認します。すべての日付演算はUTCの深夜0時基準でのみ処理し、 "今日"はKSTで計算します。

開発

npm install
npm run dev        # http://localhost:3000
npm run verify     # 공휴일 규칙 검증
npm run typecheck
npm run build

MCP Inspectorでツールを直接叩くこともできます。

npx @modelcontextprotocol/inspector
# Transport: Streamable HTTP / URL: http://localhost:3000/api/mcp

構造

app/
  api/mcp/route.ts   MCP 서버 (도구 6개 등록)
  page.tsx           랜딩 + 연결 가이드
lib/
  date.ts            타임존 안전 날짜 유틸
  holidays.ts        공휴일 규칙 엔진 (법령 구현)
  overrides.ts       임시공휴일·선거일 수동 테이블
  format.ts          응답 텍스트 포맷터
scripts/
  verify.ts          공개 자료 대조 검증

デプロイ

Vercelにこのリポジトリを接続すればそのままデプロイされます。環境変数は不要です。 コネクタURLはデプロイドメインの後ろに/api/mcpを付けたアドレスで、ランディングページが自分のドメインを読み取って 自動的に正しいURLを表示します。

プライバシー

日付文字列だけを受け取って計算結果を返します。ユーザーデータを保存したり外部に送信したりしません。

ライセンス

MIT