한국 공휴일 MCP

连接器 URL: https://korea-holiday-mcp.vercel.app/api/mcp 介绍页面: https://korea-holiday-mcp.vercel.app

只需在 Claude 中注册一个 URL，就能准确处理韩国公休日、替代公休日、营业日计算的 MCP 服务器。由于是无认证的公开连接器，无需安装、登录或 API 密钥。

为什么需要

LLM 不擅长日期运算。韩国公休日涉及农历节日（春节、中秋节、佛诞节）和替代公休日规则，模型很容易给出看似合理的错误答案。实际中经常出错的地方：

• 显忠日没有替代公休日。 2027年6月6日是周日，但6月7日是正常工作日。显忠日不是国庆日，因此不属于《关于政府机关公休日的规定》第3条的适用对象。

• 春节、中秋节只有在与周日重叠时才会产生替代公休日。即使与周六重叠也不会增加。

• 制宪节从2026年起重新成为公休日。 这是自2008年排除后时隔18年回归，训练数据中几乎没有。

该服务器不是死记日期表，而是将法令用代码实现，每次都能确定性地给出相同答案。

连接方法

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）— 是否将劳动节（5/1）计为假日。 劳动节不是政府机关公休日，而是《劳动基准法》规定的带薪休假日，因此默认视为营业日。

• saturdayIsBusinessDay（默认 false）— 是否将周六计为营业日。

数据依据与局限

依据法令：《关于政府机关公休日的规定》第2条（公休日）·第3条（替代公休日）

替代公休日规则反映施行日期，按年度不同适用。

查询范围：2015~2050年。农历数据只到2050年，之后会返回错误。

不包含的内容

• 各公司创立纪念日、各行业休息日

• 尚未确定的未来临时公休日、选举日

临时公休日和选举日无法通过规则预测，因此只将已确定、公布的内容手动登记到 lib/overrides.ts 中。一旦新指定，添加一行并运行 npm run verify 即可。

可能与民间日历网站不同的地方

一些公休日整理网站将2027年6月6日（周日）显忠日的6月7日显示为替代公休日。 该服务器依照法令计算为无替代公休日。2021年人事革新处修订时，替代公休日 对象中明确排除了元旦和显忠日，此后2023年修订新增的只有佛诞节和 圣诞节。实际上2021年6月6日（周日）也没有替代公休日。

重要决策请通过官报或人事革新处公告再次确认。 如果计算结果有异常，请通过 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