{"repo":"imsyuan/taiwan-holidays","free":true,"listed":false,"github":"https://github.com/imsyuan/taiwan-holidays","clone":"git clone https://github.com/imsyuan/taiwan-holidays.git","description":"台灣工作日計算引擎 · Taiwan Workday Engine — 補班調移授權資料 + 連假偵測 + 請假最佳化 + MCP server for AI agents","language":"JavaScript","stars":16,"topics":["cloudflare-workers","fintech","holiday","hr","mcp","taiwan","workday"],"license":"MIT","category":"mcp-servers","readme_excerpt":"Taiwan Holidays API 台灣國定假日的視覺化日曆、JSON API 與 工作日計算引擎 。涵蓋國定假日、補班日、農民曆與請假攻略；除了裸 JSON，還提供一個 remote MCP server，讓 AI／agent 直接在台灣行事曆上「做時間決策」，而不只是查哪天放假。 ✨ 特色 - 🗓️ 完整日曆資料 — 涵蓋每日的上班/放假狀態與節日說明 - ✈️ 國定假日清單 — 只列出真正的國定假日（不含週末） - 💼 補班日清單 — 快速查詢需要補班的日期 - 🌕 農民曆支援 — 內建農曆日期、傳統節慶與二十四節氣 - 🌐 中英雙語 — 提供英文版本，方便國際化應用 - 🔄 自動同步更新 — GitHub Actions 定期從政府開放資料同步 - 📦 CDN 快速存取 — jsDelivr 全球 CDN 加速 - 🧮 工作日計算引擎 — 不只查假日，還能算工作日、補班、請假最佳化（透過 MCP server） 🚀 快速開始 三種使用方式，各取所需： 你想要 用這個 入口 --- --- --- 看視覺化日曆、請假攻略 網站 tw-holidays.gooliya.com 在程式裡取假日／補班資料 JSON API（jsDelivr CDN） 見下方「JSON API」 讓 AI／agent 算工作日、請假 MCP server 見下方「MCP Server」 🔗 JSON API（透過 jsDelivr CDN） 所有資料都可透過 jsDelivr CDN 存取，以 2026 年為例： 完整日曆（中文） 國定假日（中文） 國定假日（英文） 補班日清單 完整日曆（英文） 💡 其他年份只需將 2026 替換為 2017 2026 程式範例 JavaScript - 取得國定假日 JavaScript - 英文版國定假日 Python - 查詢補班日 🤖 MCP Server（台灣工作日計算引擎） 把台灣行事曆變成一個 AI 可呼叫的工作日計算引擎 ：不只查假日，還能算工作日、補班、請假最佳化與出遊時段，供 LLM／agent 與 HR／企業做時間決策。原始碼在 mcp/ ，純函式引擎與 MCP 外殼解耦，部署於 Cloudflare Workers，透過 Streamable HTTP 對外。 正式端點（無需認證，公開唯讀）： 💡 MCP server 內建運算邏輯，並直接讀取與 Worker 一起 bundle 的 data/ .json ，不在執行時繞 jsDelivr。 如何使用 連上後就能用自然語言問：「2026 我有 5 天年假怎麼請最划算？」「今天起算 10 個工作日是哪天？」「下一個補班日？」 Claude.ai（網頁／桌面）— 自訂 Connector 1. Settings → Connectors → Add custom connector 2. Name 填 Taiwan Workday ，URL 填上面的正式端點 3. 在對話中啟用該 connector 即可（需支援自訂 connector 的方案） Claude Code（CLI） MCP Inspector（除錯／探索） 其他 MCP client／agent ：transport 選 Streamable HTTP，指向同一網址即可。 工具一覽 工具 用途 輸入 輸出 --- --- --- --- count workdays 區間工作日數（自動扣假日、補班計入工作日） { start, end } { workdays, ho","default_branch":null,"files":null,"tree":[],"storefront":"/r/imsyuan","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/imsyuan/taiwan-holidays/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}