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 버전)

• 음력/황력/24절기(만년력)

• 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.

License

MIT