cn-holiday-mcp

MCP-сервер (Model Context Protocol) для запроса официальных праздников Китая и компенсационных рабочих дней (调休). Ноль зависимостей, работает офлайн, готов к использованию из коробки.

Источник данных: уведомления 国务院办公厅 «О расписании некоторых праздников на 2025 год» и «О расписании некоторых праздников на 2026 год» (国办发明电).

Возможности

• ✅ Ноль зависимостей: только стандартная библиотека Node.js, работает напрямую с node >= 18

• ✅ Транспорт stdio, соответствует протоколу MCP 2024-11-05

• ✅ Полные данные за 2025 и 2026 годы (включая все компенсационные рабочие дни)

• ✅ Два инструмента: query_holiday (проверка конкретного дня), list_holidays (список за год)

Быстрый старт

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

Подключение к Claude Desktop

Отредактируйте claude_desktop_config.json:

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

Инструменты

Примеры вопросов и ответов

• 2026-02-14 → «компенсационный рабочий день праздника Весны, нужно работать»

• 2026-10-05 → «праздник Национального дня, всего 7 дней»

• 2026-03-10 → «обычный рабочий день»

Дорожная карта (Pro-версия)

• Лунный календарь / астрологический календарь / солнечные термины (вечный календарь)

• Данные за 2027 год и далее (обновление после официальной публикации)

• API для корпоративных графиков, подписка (HTTP + token)

• Праздники других стран

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.

Лицензия

MIT