cn-holiday-mcp

A MCP (Model Context Protocol) server for querying Chinese statutory holidays and makeup workdays, zero-dependency, offline-ready, and works out of the box.

Data source: General Office of the State Council's Notice on the Arrangement of Some Holidays in 2025 and Notice on the Arrangement of Some Holidays in 2026 (State Council Office Circular).

Features

• ✅ Zero-dependency: pure Node.js standard library, runs directly with node >= 18

• ✅ stdio transport, compliant with MCP 2024-11-05 protocol

• ✅ Complete data for 2025 and 2026 (including all makeup workdays)

• ✅ Two tools: query_holiday (query a specific day), list_holidays (list the whole year)

Quick Start

node src/server.mjs          # 直接运行
npm start                    # 或通过 npm script
node tests/smoke.mjs         # 冒烟测试

Connect to Claude Desktop

Edit claude_desktop_config.json:

{
  "mcpServers": {
    "cn-holiday": {
      "command": "node",
      "args": ["C:\\path\\to\\cn-holiday-mcp\\src\\server.mjs"]
    }
  }
}

Tools

Example Q&A

• 2026-02-14 → "Makeup workday for Spring Festival, work required"

• 2026-10-05 → "National Day holiday, 7 days total"

• 2026-03-10 → "Regular working day"

Roadmap (Pro)

• Lunar calendar / almanac / solar terms (perpetual calendar)

• 2027 and beyond (updated as soon as officially released)

• Enterprise scheduling API, subscription-based (HTTP + token)

• Holidays in multiple countries

English

cn-holiday-mcp is a zero-dependency MCP server for Chinese public holidays and makeup workdays (调休), covering 2025–2026 per official State Council notices. No API keys, no network calls, fully offline.

Tools

• query_holiday — is a given date (YYYY-MM-DD) a public holiday, a makeup workday, or a regular working day?

• list_holidays — full yearly schedule including makeup workdays.

Run

node src/server.mjs   # Node.js >= 18, nothing to install

Install — Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "cn-holiday": {
      "command": "node",
      "args": ["C:\\path\\to\\cn-holiday-mcp\\src\\server.mjs"]
    }
  }
}

Roadmap — lunar calendar / solar terms; 2027+ schedules; enterprise scheduling API (subscription); more countries.

License

MIT