MCP.so
Sign In

China Festival Mcp

@Eis4TY

Repository

About China Festival Mcp

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

#calendar#festival

Basic information

Category

Other

Transports

stdio

Publisher

Eis4TY

Submitted by

Tianyi Yang

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

10

查询指定日期的节假日信息，包含是否为节假日的判断 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

Overview

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.

What runtime does China Festival Mcp require?

The server is run via uvx, indicating a Python runtime environment managed by the uv package installer.

Where does the holiday data come from?

The project is based on the open-source PyLunar and holiday-cn projects.

Does China Festival Mcp require authentication or network access?

—

Are there any known limits on date ranges for lunar conversion or Bazi calculation?

—

Comments

More Other MCP servers

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

Nginx UI

0xJacky

Yet another WebUI for Nginx

11.3K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K