cn-holiday-mcp

Ein MCP-Server (Model Context Protocol) zur Abfrage chinesischer gesetzlicher Feiertage und Ausgleichsarbeitstage – ohne Abhängigkeiten, offline nutzbar und sofort einsatzbereit.

Datenquelle: Mitteilungen des Büros des Staatsrats über die Anordnung der Feiertage im Jahr 2025 und im Jahr 2026 (国办发明电).

Funktionen

• ✅ Keine Abhängigkeiten: pure Node.js-Standardbibliothek, läuft direkt mit node >= 18

• ✅ stdio-Transport, konform mit dem MCP-Protokoll 2024-11-05

• ✅ Vollständige Daten für 2025 und 2026 (einschließlich aller Ausgleichsarbeitstage)

• ✅ Zwei Werkzeuge: query_holiday (bestimmten Tag abfragen), list_holidays (das ganze Jahr auflisten)

Schnellstart

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

Anbindung an Claude Desktop

claude_desktop_config.json bearbeiten:

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

Werkzeuge

Beispielfragen und Antworten

• 2026-02-14 → „Ausgleichsarbeitstag zum Frühlingsfest, Arbeit erforderlich“

• 2026-10-05 → „Feiertage zum Nationalfeiertag, insgesamt 7 Tage“

• 2026-03-10 → „normaler Arbeitstag“

Roadmap (Pro-Version)

• Mondkalender / Almanach / Solarterme (Ewiger Kalender)

• Daten ab 2027 (Aktualisierung nach offizieller Veröffentlichung)

• Unternehmens-Schichtplanungs-API, Abo-Modell (HTTP + token)

• Feiertage in mehreren Ländern

Englisch

cn-holiday-mcp ist ein MCP-Server ohne Abhängigkeiten für chinesische gesetzliche Feiertage und Ausgleichsarbeitstage (调休) gemäß den offiziellen Bekanntmachungen des Staatsrats für den Zeitraum 2025–2026. Keine API-Schlüssel, keine Netzwerkaufrufe, vollständig offline.

Werkzeuge

• query_holiday – prüft, ob ein bestimmtes Datum (YYYY-MM-DD) ein gesetzlicher Feiertag, ein Ausgleichsarbeitstag oder ein normaler Werktag ist.

• list_holidays – vollständiger Jahresplan einschließlich Ausgleichsarbeitstagen.

Ausführen

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

Installation – Claude Desktop claude_desktop_config.json:

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

Roadmap – Mondkalender / Solarterme; Zeitpläne ab 2027+; Schichtplanungs-API für Unternehmen (Abo); weitere Länder.

Lizenz

MIT