Taiwan Holiday MCP Server

# 2026 年支援更新報告 **完成日期**: 2025-10-08 **更新版本**: 1.0.3 (準備中) ## 📋 更新摘要 台灣假期 MCP 伺服器已成功擴展支援至 2026 年，現在支援的年份範圍為 **2017-2026**。 ## 🔧 技術變更 ### 1. 核心型別更新 - **檔案**: `src/types.ts` - **變更**: `SUPPORTED_YEAR_RANGE.end` 從 `2025` 更新為 `2026` ### 2. 伺服器邏輯更新 - **檔案**: `src/server.ts` - **變更**: - 工具 schema 中的 `maximum` 年份限制更新為 `2026` - 年份驗證邏輯更新支援範圍至 `2017-2026` - 年份資源生成迴圈擴展至 `2026` ### 3. 文件更新 - **檔案**: `docs/api-reference.md`, `README.md` - **變更**: 所有年份範圍說明從 `2017-2025` 更新為 `2017-2026` ### 4. 測試案例更新 - **檔案**: 多個測試檔案 - **變更**: - 更新年份範圍驗證測試 - 修正無效年份測試案例（從 `2026` 改為 `2027`） - 更新支援年份列表驗證 ## 🧪 驗證結果 ### 資料來源驗證 ```bash curl -I https://cdn.jsdelivr.net/gh/ruyut/TaiwanCalendar/data/2026.json # HTTP/2 200 - 2026 年資料確實存在 ``` ### 功能測試結果 ``` 🔍 測試 2026 年支援... ✅ 2026 年假期資料獲取成功 📊 2026 年假期數量: 120 🎉 2026-01-01 (元旦): 是假期 📈 2026 年統計: { 總假期: 120, 國定假日: 114, 補假: 6 } 🎯 2026 年支援測試完成！ ``` ### 年份範圍驗證 ``` 📅 支援的年份範圍: { start: 2017, end: 2026 } ✅ 2026 年支援狀態: 已支援 🔍 2025 年: ✅ 支援 🔍 2026 年: ✅ 支援 🔍 2027 年: ❌ 不支援 ``` ## 📊 測試覆蓋 - ✅ 單元測試：245 個測試通過 - ✅ 整合測試：網路連接測試通過 - ✅ 端到端測試：MCP 協議測試通過 - ✅ 資料驗證：2026 年資料格式正確 ## 🎯 使用範例 ### 查詢 2026 年假期 ```javascript // 檢查 2026 年元旦 const result = await mcpClient.callTool({ name: 'check_holiday', arguments: { date: '2026-01-01' } }); // 獲取 2026 年所有假期 const holidays = await mcpClient.callTool({ name: 'get_holidays_in_range', arguments: { startDate: '2026-01-01', endDate: '2026-12-31' } }); // 獲取 2026 年統計 const stats = await mcpClient.callTool({ name: 'get_holiday_stats', arguments: { year: 2026 } }); ``` ### MCP 資源存取 ```json { "method": "resources/read", "params": { "uri": "taiwan-holidays://holidays/2026" } } ``` ## 🚀 部署建議 1. **版本更新**: 建議將版本號更新為 `1.0.3` 2. **文件同步**: 確保所有客戶端文件同步更新年份範圍 3. **向後相容**: 此更新完全向後相容，不會影響現有功能 ## 📝 後續維護 - **2027 年**: 當 TaiwanCalendar 發布 2027 年資料時，可依循相同流程擴展支援 - **監控**: 建議定期檢查資料來源的更新狀態 - **測試**: 每年初建議執行完整的年份支援測試 --- **更新完成**: 台灣假期 MCP 伺服器現已完全支援 2026 年查詢 🎉