Korea Business Calendar

io.github.groove79由 GitHub 账号 groove79 发布v0.1.1更新于 Oct 29, 2026

Korean tax/payroll deadlines, public holidays, business-day math. No keys. 세무 일정·영업일 MCP.

已验证STDIO仅桌面效率与工作流金融

概览

AI 生成的概览

面向韩国营业日的离线 MCP 服务器：公休日、营业日计算以及税务与工资申报截止日。

可以做什么
  • 按年份列出韩国公休日，含替代公休日与选举日
  • 判断某日期是否为营业日，并给出下一个和上一个营业日
  • 按营业日加减天数，或统计两个日期之间的营业日数
  • 按企业类型返回税务与工资申报日程，可按月份或未来天数筛选
  • 按 id 解释某一项税务或工资义务：是什么、由谁申报、何时申报
适用场景
适合助手协助处理韩国相关日程：交货承诺、配送预计到达、会议日期、工资日历，或回答某韩国企业本月需要申报什么。
运行要求
以 stdio 方式在本机运行，通常通过 npx 启动该 npm 包。无需 API 密钥、账号或网络访问；2025–2028 年的农历节日日期已内置。
安装前请注意
申报日程只是排期辅助，并非税务建议，README 建议以 홈택스 公告为准。성실신고확인、반기납부、수정신고 等特殊制度仅作说明、不做计算；2025–2028 年之外的农历节日需由调用方提供。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Korea Business Calendar，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@appmonster/mcp-kr-biz-calendar

MCP server for Korean business dates — no keys, no network. An agent gets:

  • Public holidays with computed 대체공휴일 and election days (2025–2028 lunar table built in)
  • Business-day math: "3 영업일 후", count business days between dates, next/previous business day
  • Tax & payroll calendar per business profile: 부가세 확정·예정, 종합소득세, 법인세, 원천세·4대보험 매월 10일, 지급명세서, 연말정산 — each moved to the next business day when it lands on a holiday (국세기본법 §5)

한국 사업자용 세무·노무 일정과 영업일 계산. 키 없이 바로 동작.

Tools

ToolWhat it does
kr_list_holidays연도별 공휴일 (대체공휴일·선거일 포함)
kr_is_business_day영업일 여부 + 다음/이전 영업일
kr_add_business_days영업일 더하기/빼기, 두 날짜 사이 영업일 수
kr_tax_calendar사업자 유형(개인·간이·법인·면세)·고용 여부별 신고 일정, 월/다가오는 N일 필터
kr_tax_rule일정 항목 설명 (무엇을, 누가, 언제)

Setup

json
{ "mcpServers": { "kr-biz-calendar": { "command": "npx", "args": ["-y", "@appmonster/mcp-kr-biz-calendar"] } } }

Examples

  • "이번 달 우리 회사가 신고할 거 뭐 있어?" → kr_tax_calendar {entity: "corporation", employees: true, month: 10}
  • "오늘 발송하면 영업일 3일 뒤 도착 — 언제?" → kr_add_business_days {days: 3}
  • "1/25가 일요일인데 부가세 언제까지?" → calendar already returns 2026-01-26 (shifted)

Coverage & accuracy

  • Lunar holidays (설날·추석·부처님오신날) are tabled for 2025–2028. For other years pass extraHolidays from the public-data server's kr_holidays (official KASI data); the tools say so in note.
  • Substitute-holiday rules follow the 2023 amendment (all holidays except 신정·현충일; overlaps count).
  • Deadlines encode standard rules for a 12월 결산 법인 and calendar-year individuals. Special regimes (성실신고확인, 반기납부, 수정신고) are noted in what, not computed. Always confirm with 홈택스 notices; this is a scheduling aid, not tax advice.

Development

bash
pnpm --filter @appmonster/mcp-kr-biz-calendar test

来源：packages/kr-biz-calendar/README.md，提交 2f1998f

工具

5

kr_list_holidays

List Korean public holidays for a year including computed 대체공휴일 (substitute holidays) and election days. Offline; lunar dates tabled for 2025–2028. 연도별 공휴일(대체공휴일 포함)을 반환합니다. Use for scheduling, delivery promises, payroll calendars. Needs year.

输入参数year必填extraHolidays

kr_is_business_day

Tell whether a date is a Korean business day (평일, not a public holiday), and give the next and previous business days. 해당 날짜가 영업일인지 확인합니다. Use before promising a delivery/meeting date. Needs a date (default today, KST).

输入参数dateextraHolidays

kr_add_business_days

Add (or subtract) N Korean business days to a date, skipping weekends and public holidays — e.g. '3 business days after today' for shipping ETAs, or count business days between two dates. 영업일 기준으로 날짜를 더하거나 두 날짜 사이 영업일 수를 셉니다. Use for 납기·배송·결제 기한 계산. Needs from (default today) and either days or to.

输入参数todaysfromextraHolidays

kr_tax_calendar

Korean tax & payroll filing deadlines for a business profile: VAT (부가세 확정·예정), income/corporate tax, withholding (원천세) and 4대보험 monthly, 지급명세서, 연말정산 — each shifted to the next business day when it falls on a holiday. Filter by month or 'upcoming'. 사업자 유형별 세무·노무 신고 일정을 반환합니다. Use for '이번 달 신고할 것', reminders, cash planning. Needs entity (individual/simplified/corporation/taxfree); employees true if you pay anyone.

输入参数yearmonthentityemployeesupcomingDaysextraHolidayswithholdingHalfYear

kr_tax_rule

Explain one recurring Korean tax/payroll obligation by id (from kr_tax_calendar): what it is, who files, when, and the base dates. 세무 일정 항목의 설명을 반환합니다. Use when the agent needs to tell the owner what a deadline means. Needs id.

输入参数id

版本历史

2
  1. v0.1.1最新Oct 23, 2026
  2. v0.1.0Oct 21, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分