한국 공휴일 MCP

URL коннектора: https://korea-holiday-mcp.vercel.app/api/mcp Страница с описанием: https://korea-holiday-mcp.vercel.app

Это MCP-сервер, который точно обрабатывает расчёт корейских государственных праздников, заменяющих праздников и рабочих дней, если зарегистрировать в Claude всего один URL. Поскольку это публичный коннектор без аутентификации, не требуются установка, вход в систему или API-ключ.

Зачем это нужно

LLM слабы в арифметике с датами. Корейские государственные праздники переплетены с праздниками по лунному календарю (Соллаль, Чхусок, День рождения Будды) и правилами заменяющих праздников, поэтому модели легко дают правдоподобно выглядящие неверные ответы. Вот частые ошибки:

• В День памяти нет заменяющего праздника. 6 июня 2027 года — воскресенье, но 7 июня — обычный рабочий день. День памяти не является национальным праздником, поэтому на него не распространяется статья 3 «Положения о государственных праздниках в государственных учреждениях».

• Соллаль и Чхусок получают заменяющий праздник, только если совпадают с воскресеньем. Даже при совпадении с субботой дополнительного выходного не добавляется.

• День Конституции с 2026 года снова является государственным праздником. Он возвращается спустя 18 лет после исключения в 2008 году, поэтому в обучающих данных его почти нет.

Этот сервер не заучивает таблицу дат, а реализует законодательство в коде, поэтому каждый раз даёт один и тот же детерминированный ответ.

Способы подключения

Веб-версия и десктопное приложение Claude

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) — учитывать ли День труда (1 мая) как праздничный день. День труда — не государственный праздник, а оплачиваемый выходной по Трудовому кодексу, поэтому по умолчанию он считается рабочим днём.

• saturdayIsBusinessDay (по умолчанию false) — считать ли субботу рабочим днём.

Источники данных и ограничения

Правовое основание: статья 2 (государственные праздники) и статья 3 (заменяющие праздники) «Положения о государственных праздниках в государственных учреждениях».

Правила заменяющих праздников применяются по-разному в зависимости от года, с учётом даты вступления в силу.

Диапазон запросов: 2015~2050 годы. Данные лунного календаря есть только до 2050 года, поэтому для более поздних дат возвращается ошибка.

Что не включается

• Корпоративные годовщины основания, отраслевые выходные дни

• Неподтверждённые будущие временные праздники и дни выборов

Временные праздники и дни выборов невозможно предсказать по правилам, поэтому в lib/overrides.ts вручную вносятся только уже утверждённые и официально объявленные. Когда назначается новый, достаточно добавить одну строку и запустить npm run verify.

Возможные расхождения с частными календарными сайтами

Некоторые сайты со списками праздников указывают 7 июня как заменяющий праздник для Дня памяти 6 июня 2027 года (воскресенье). Этот сервер в соответствии с законодательством рассчитывает отсутствие заменяющего праздника. При пересмотре правил в 2021 году 인사혁신처 явно исключило Новый год и День памяти из числа объектов заменяющих праздников, а последующей поправкой 2023 года были добавлены только День рождения Будды и Рождество. Фактически 6 июня 2021 года (воскресенье) заменяющего праздника тоже не было.

Для важных решений перепроверяйте по официальному вестнику или объявлениям 인사혁신처. Если в результатах расчёта обнаружите ошибку, сообщите через issue.

Проверка

Результаты работы механизма правил сверяются с открытыми данными (2024~2027 годы).

npm run verify

Также проверяется, что результаты одинаковы независимо от часового пояса. Все операции с датами выполняются только относительно полуночи UTC, а «сегодня» вычисляется по 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