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 分