cn-holiday-mcp

Servidor MCP (Model Context Protocol) para consultar los días festivos oficiales chinos y los días laborables de compensación, con cero dependencias, disponible sin conexión y listo para usar.

Fuente de datos: 国务院办公厅《关于 2025 年部分节假日安排的通知》《关于 2026 年部分节假日安排的通知》（国办发明电）.

Características

• ✅ Cero dependencias: solo biblioteca estándar de Node.js, se ejecuta directamente con node >= 18

• ✅ Transporte stdio, compatible con el protocolo MCP 2024-11-05

• ✅ Incluye datos completos de 2025 y 2026 (incluidos todos los días laborables de compensación)

• ✅ Dos herramientas: query_holiday (consulta un día concreto), list_holidays (lista todo el año)

Inicio rápido

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

Integración con Claude Desktop

Edita claude_desktop_config.json:

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

Herramientas

Ejemplos de preguntas y respuestas

• 2026-02-14 → «Día laborable de compensación del Festival de Primavera, hay que trabajar»

• 2026-10-05 → «Vacaciones del Día Nacional, 7 días en total»

• 2026-03-10 → «Día laborable normal»

Hoja de ruta (versión Pro)

• Calendario lunar / almanaque / términos solares (calendario perpetuo)

• Datos de 2027 y posteriores (se actualizan cuando se publican oficialmente)

• API de programación de turnos para empresas, modelo de suscripción (HTTP + token)

• Festivos de varios países

Inglés

cn-holiday-mcp es un servidor MCP de cero dependencias para los días festivos públicos chinos y los días laborables de compensación (调休), que cubre 2025–2026 según los avisos oficiales del Consejo de Estado. Sin claves API, sin llamadas de red, totalmente sin conexión.

Herramientas

• query_holiday — ¿es una fecha dada (YYYY-MM-DD) un día festivo público, un día laborable de compensación o un día laborable normal?

• list_holidays — calendario anual completo, incluidos los días laborables de compensación.

Ejecución

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

Instalación — Claude Desktop claude_desktop_config.json:

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

Hoja de ruta — calendario lunar / términos solares; calendarios de 2027 y posteriores; API de programación de turnos para empresas (suscripción); más países.

Licencia

MIT