cn-holiday-mcp

中国の法定祝日・振替出勤日を照会する MCP（Model Context Protocol）サーバー。ゼロ依存、オフライン対応、すぐに使えます。

データソース：国務院弁公庁『2025年の一部祝祭日の手配に関する通知』『2026年の一部祝祭日の手配に関する通知』（国弁発明電）。

特徴

• ✅ ゼロ依存：純粋な Node.js 標準ライブラリ、node >= 18 でそのまま動作

• ✅ stdio トランスポート、MCP 2024-11-05 プロトコル準拠

• ✅ 2025年・2026年の完全なデータを収録（全振替出勤日を含む）

• ✅ 2つのツール：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"]
    }
  }
}

ツール

サンプルQ&A

• 2026-02-14 → 「春節の振替出勤日、出勤が必要」

• 2026-10-05 → 「国慶節の休暇、合計7日間」

• 2026-03-10 → 「通常の平日」

ロードマップ（Pro版）

• 旧暦/こよみ/二十四節気（万年暦）

• 2027年以降のデータ（公式発表次第更新）

• 企業向けシフトAPI、サブスクリプション制（HTTP + token）

• 多言語の祝日

English

cn-holiday-mcp は、中国の祝日と振替出勤日（调休）のためのゼロ依存のMCPサーバーです。国務院の公式通知に基づき2025〜2026年をカバー。APIキー不要、ネットワーク呼び出し不要、完全オフライン。

ツール

• query_holiday — 指定した日付（YYYY-MM-DD）が祝日か、振替出勤日か、通常の平日かを判定

• list_holidays — 振替出勤日を含む年間スケジュールを一覧表示

実行

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

インストール — Claude Desktop の claude_desktop_config.json：

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

ロードマップ — 旧暦/二十四節気；2027年以降のスケジュール；企業向けシフトAPI（サブスクリプション）；他国対応

ライセンス

MIT