Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@cn-holiday-mcp Is 2026-02-14 a holiday or makeup workday?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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).
✅ 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)
Related MCP server: Nager MCP v202 MCP Server
node src/server.mjs # 直接运行
npm start # 或通过 npm script
node tests/smoke.mjs # 冒烟测试Edit claude_desktop_config.json:
{
"mcpServers": {
"cn-holiday": {
"command": "node",
"args": ["C:\\path\\to\\cn-holiday-mcp\\src\\server.mjs"]
}
}
}Tool | Parameters | Example |
|
|
|
|
|
|
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"
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
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 installInstall — 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.
MIT
列出某一年（或全部已收录年份）的法定节假日安排，包括放假区间、天数与调休上班日。
Inputs: year.
查询某一天（YYYY-MM-DD）是法定节假日、调休上班日还是普通工作日。返回节假日名称、放假区间和该区间内的调休上班日。
Inputs: date (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 2 tools
query_holiday targets a single specific date while list_holidays returns full annual arrangements, so their purposes are clearly distinct. There is no practical overlap that would cause an agent to misselect.
Both tool names follow a consistent verb_noun pattern: query_holiday and list_holidays. The only minor difference is singular versus plural noun, which is natural and does not harm consistency.
Two tools is slightly thin, but each tool earns its place for the server's narrow read-only purpose. It falls at the borderline edge of the typical 3-15 tool range.
The server covers the core holiday use cases: checking a specific day and listing a year's holiday schedule. Minor gaps exist, such as date-range lookups or upcoming-holiday queries, but they are workable conveniences rather than critical dead ends.
MCP server for China public holidays and lunar calendar: solar-lunar conversion and yearly schedule.
MCP server for China Railway 12306 ticket availability: schedules and seats by Chinese station name.
MCP server for China Railway 12306 ticket availability: schedules and seats by Chinese station name.
MCP server for China administrative divisions: province/city/district lookup, adcode resolution and