CN Calendar Skill

Chinese calendar MCP server — holidays, lunar/solar conversion, 24 solar terms, workday calculation, 13 endpoints, zero API dependency

GitHub

cn-calendar-skill

中国日历全栈工具包 — 判断工作日 · 计算假期 · 农历转换 · 节气查询

skills.sh License: MIT Agent-Agnostic

一句话安装

npx skills add demo112/cn-calendar-skill

装完直接对 Claude Code / Codex / Cursor / Hermes 说：「6月有多少工作日？」「请2天假怎么连最长？」

完全离线 · 零 API Key · 零网络请求 · 国务院官方数据

解决什么痛点？

每个中国开发者都遇到过这些场景：

# ❌ 硬编码节假日 — 每年更新，调休补班容易漏
if date in ['2026-01-01', '2026-01-02', ...]:
    ...

# ❌ 调外部 API — 被限频/掉线/收费
requests.get('https://some-api.com/holiday?date=2026-06-19')

# ✅ 用 cn-calendar-skill — 一句话搞定
"今天开票，合同写30个工作日付款，到期日是哪天？"

SKILL.md 内嵌了完整的 Python 代码 + 国务院调休数据（2004-2026），装上就能用。

13 个端点

📅 日历层

端点用途示例
is_workday_cn(date)工作日判定（含调休补班）2026-09-28 周日补班 → True
next_holiday(date)下一个法定假 + 起止日期→ 国庆节 10/1-10/7
cn_date_info(date)综合查询（一键返回全部）→ 工作日+农历+节气+星座

💼 工作日层

端点用途场景
add_workdays(start, n)第 N 个工作日账期/物流时效
count_workdays(start, end)区间工作日数HR 考勤/排班
find_bridge_leaves(date, n)请 N 天假连出 X 天请假性价比排序

🌙 农历层

端点用途
solar_to_lunar(date)公历 → 农历
lunar_to_solar(year, month, day)农历 → 公历
get_solar_term(date)当前/下一节气
get_zodiac(year) / get_zodiac_strict(date)生肖（公历/农历）
get_constellation(date)12 星座

真实对话示例

👤 "6月份有多少工作日，端午是几号到几号？"
🤖 6月有 20 个工作日。端午节 5/31-6/2 放假 3 天。

👤 "请2天假，怎么请最划算？"
🤖 推荐方案：6/26(五) + 6/29(一) 请假 2 天，连出 5 天假期(6/26-6/30)。

👤 "客户合同写'开票后 30 个工作日付款'，今天开票，到期日？"
🤖 30 个工作日后是 2026-07-13（周一）。

👤 "我妈生日农历八月初八，今年公历哪天？"
🤖 农历八月初八 → 2026-09-18（周五）。

技术细节

数据来源：

  • 法定节假日：chinese-calendar（国务院办公厅官方通知，2004-2026）
  • 农历：zhdate（1900-2100）
  • 节气：天文公式，21 世纪精度 ±1 天

依赖安装：

pip install chinese-calendar zhdate

兼容 Agent： Claude Code · Codex · Cursor · Hermes · Cline · OpenCode · Windsurf · 任何支持 SKILL.md 的 Agent

谁在用？

  • HR 团队 — 自动排班 / 考勤统计
  • 电商运营 — 大促日期规划（中秋/国庆/双十一）
  • 财务部门 — 合同账期计算（工作日口径）
  • 物流公司 — 时效承诺（工作日口径）
  • 个人开发者 — 请假规划 / 农历生日提醒

支持

Donate

如果帮到了你的工作流：

  • ETH/USDT (ERC-20): 0xddD9f45e14c92846f47C1c1A4431aC2b41D87273

License

MIT © 2026 云渡 (Hermes Agent)

Serveurs connexes