한국 공휴일 MCP

커넥터 URL: https://korea-holiday-mcp.vercel.app/api/mcp 소개 페이지: https://korea-holiday-mcp.vercel.app

Claude에 URL 하나만 등록하면 한국 공휴일·대체공휴일·영업일 계산을 정확하게 처리하는 MCP 서버입니다. 인증이 없는 공개 커넥터라서 설치·로그인·API 키가 필요 없습니다.

Warum nötig?

LLMs sind schwach bei Datumsarithmetik. Koreanische Feiertage sind mit Mondfesten (Seollal, Chuseok, Buddhas Geburtstag) und Ersatzfeiertagsregeln verflochten, sodass Modelle leicht plausible falsche Antworten geben. Häufige Fehlerpunkte:

• Am Memorial Day gibt es keinen Ersatzfeiertag. Der 6. Juni 2027 ist ein Sonntag, aber der 7. Juni ist ein normaler Arbeitstag. Der Memorial Day ist kein Nationalfeiertag und fällt daher nicht unter Artikel 3 der „Verordnung über die Feiertage öffentlicher Ämter“.

• Seollal und Chuseok erzeugen nur dann einen Ersatzfeiertag, wenn sie auf einen Sonntag fallen. Selbst wenn sie auf einen Samstag fallen, gibt es keinen zusätzlichen Tag.

• Der Verfassungstag ist ab 2026 wieder ein Feiertag. Nach der Streichung 2008 ist es die Rückkehr nach 18 Jahren, daher kommt er in den Trainingsdaten kaum vor.

Dieser Server merkt sich keine Datumstabellen, sondern implementiert die Rechtsvorschriften als Code und liefert daher jedes Mal deterministisch dieselbe Antwort.

Verbindungsmethoden

Claude Web · Desktop-App

1. Gehen Sie zu Einstellungen → Connectors

2. Klicken Sie auf Benutzerdefinierten Connector hinzufügen

3. Geben Sie als Namen 한국 공휴일 und als URL https://korea-holiday-mcp.vercel.app/api/mcp ein

4. Aktivieren Sie es im Tool-Menü des Chatfensters

Da es sich um einen öffentlichen Server ohne Authentifizierung handelt, erscheint kein Anmeldeschritt. Wenn Sie ihn als Connector für Organisationsadministratoren registrieren, kann ein Bildschirm erscheinen, der OAuth erwartet. Fügen Sie ihn daher als persönlichen Connector hinzu.

Claude Code

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

Wenn Sie die Konfigurationsdatei direkt schreiben

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

Werkzeuge

Allgemeine Optionen:

• includeLaborDay (Standard false) – Ob der Tag der Arbeit (1.5.) als Feiertag gezählt werden soll. Der Tag der Arbeit ist kein öffentlicher Feiertag, sondern ein bezahlter freier Tag nach dem Arbeitsgesetz; daher gilt er standardmäßig als Werktag.

• saturdayIsBusinessDay (Standard false) – Ob Samstage als Werktage gezählt werden sollen.

Datengrundlage und Grenzen

Rechtsgrundlage: Artikel 2 (Feiertage) und Artikel 3 (Ersatzfeiertage) der „Verordnung über die Feiertage öffentlicher Ämter“

Die Ersatzfeiertagsregeln werden je nach Jahr unterschiedlich angewendet, um das jeweilige Inkrafttreten zu berücksichtigen.

Abfragebereich: 2015–2050. Die Mondkalenderdaten reichen nur bis 2050; danach wird ein Fehler zurückgegeben.

Nicht enthalten

• Firmengründungsjubiläen, branchenspezifische Ruhetage

• Nicht bestätigte zukünftige Sonderfeiertage und Wahltermine

Sonderfeiertage und Wahltermine lassen sich nicht durch Regeln vorhersagen; daher werden nur bestätigte und amtlich bekannt gegebene Termine manuell in lib/overrides.ts eingetragen. Wenn neue festgelegt werden, fügen Sie eine Zeile hinzu und führen npm run verify aus.

Mögliche Abweichungen von privaten Kalender-Websites

Einige Feiertags-Websites zeigen für den Memorial Day am 6. Juni 2027 (Sonntag) den 7. Juni als Ersatzfeiertag an. Dieser Server berechnet gemäß der Verordnung keinen Ersatzfeiertag. Bei der Novelle 2021 durch das Ministerium für Personalmanagement wurden Neujahr und Memorial Day ausdrücklich von den Ersatzfeiertagen ausgenommen; durch die Novelle 2023 kamen nur Buddhas Geburtstag und Weihnachten hinzu. Tatsächlich gab es auch am 6. Juni 2021 (Sonntag) keinen Ersatzfeiertag.

Bestätigen Sie wichtige Entscheidungen zusätzlich über das Amtsblatt oder die Bekanntmachungen des Ministeriums für Personalmanagement. Wenn Sie Unstimmigkeiten in den Berechnungsergebnissen feststellen, melden Sie diese bitte als Issue.

Validierung

Die Ergebnisse der Regel-Engine werden mit öffentlichen Daten (2024–2027) abgeglichen.

npm run verify

Es wird auch geprüft, ob unabhängig von der Zeitzone dieselben Ergebnisse erzielt werden. Alle Datumsberechnungen erfolgen ausschließlich auf Basis von UTC-Mitternacht; „heute“ wird in KST berechnet.

Entwicklung

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

Sie können die Werkzeuge auch direkt mit dem MCP Inspector testen.

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

Struktur

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

Bereitstellung

Wenn Sie dieses Repository mit Vercel verbinden, wird es direkt bereitgestellt. Es sind keine Umgebungsvariablen erforderlich. Die Connector-URL ist die Adresse des Bereitstellungs-Domains mit angehängtem /api/mcp; die Landingpage liest ihre eigene Domain und zeigt automatisch die korrekte URL an.

Datenschutz

Es werden nur Datumszeichenfolgen empfangen und Berechnungsergebnisse zurückgegeben. Benutzerdaten werden weder gespeichert noch nach außen gesendet.

Lizenz

MIT