China Festival Mcp

Name: China Festival Mcp
Author: Eis4TY

@Eis4TY

代码仓库

关于 China Festival Mcp

一个基于模型上下文协议（MCP）的中国节假日和农历信息服务器，为AI助手提供准确的法定节假日、调休安排、中国传统节日、农历转换、二十四节气和八字计算功能。西方节日都是固定公历日期，不需要查询工具。

#calendar #festival

基本信息

分类

其他

传输方式

stdio

发布者

Eis4TY

提交者

Tianyi Yang

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "china-festival-mcp": {
      "command": "uvx",
      "args": [
        "china-festival-mcp"
      ]
    }
  }
}

工具

查询指定日期的节假日信息，包含是否为节假日的判断 date: 查询日期，格式：YYYY-MM-DD，不指定则查询当前日期

获取当前年份所有法定节假日

获取距离指定日期最近的下一个节假日 date: 起始日期，格式：YYYY-MM-DD，不指定则使用当前日期

获取当前年份调休工作日安排

公历转农历 date: 公历日期，格式：YYYY-MM-DD

农历转公历。用于换算中国传统节日的阳历日期。如查询七夕节是几号，根据经验七夕节固定在农历七月初七，则传入农历日期获取公历日期。 date: 农历日期，格式：YYYY-MM-DD is_leap: 是否为闰月，默认为False

获取农历日期的生肖/干支纪年 date: 公历日期，格式：YYYY-MM-DD

获取当月的二十四节气信息 date: 日期，格式：YYYY-MM-DD

计算八字（四柱） date: 日期，格式：YYYY-MM-DD hour: 小时 (0-23)，默认为12 minute: 分钟 (0-59)，默认为0

获取指定日期是星期几 date: 日期，格式：YYYY-MM-DD

概览

What is China Festival Mcp?

A Model Context Protocol (MCP) server that provides AI assistants with accurate Chinese public holiday schedules, workday adjustments, traditional festival dates, lunar calendar conversion, 24 solar terms, and Bazi (four pillars) calculation.

How to use China Festival Mcp?

Configure the server in your MCP client's mcpServers block using the command uvx with the argument china-festival-mcp. The server is invoked automatically when the client needs holiday or lunar calendar data.

Key features of China Festival Mcp

Query Chinese public holidays, traditional festivals, and workday adjustments
Convert between Gregorian and Chinese lunar dates
Retrieve detailed lunar date descriptions (zodiac, heavenly stems & earthly branches)
Look up 24 solar terms and seasonal divisions
Calculate Bazi (four pillars) and Five Elements from birth date

Use cases of China Festival Mcp

An AI scheduling assistant that adjusts reminders for Chinese holiday workdays
A travel planner that avoids travel during peak holiday periods
A cultural chatbot that correctly identifies traditional festival dates each year
A personal astrology app that computes Bazi from a user's birth date

FAQ from China Festival Mcp

What holidays does China Festival Mcp cover?

It covers Chinese public holidays, traditional festivals, and workday adjustments. Western holidays are not included as they use fixed Gregorian dates.