通胜 MCP 服务

By baranwang GitHub

中国传统黄历 MCP 服务 | Chinese Traditional Almanac MCP Service

mcp lunar-calendar

Overview

What is the Chinese Traditional Almanac MCP Service?

The Chinese Traditional Almanac MCP Service is a calculation service based on the Model Context Protocol (MCP) that provides traditional calendar information, including auspicious and inauspicious times, as well as suitable and unsuitable activities for specific dates and hours.

How to use the Chinese Traditional Almanac MCP Service?

To use the service, you can either add it to your MCP configuration using NPX or install it globally via CLI. For NPX, add the specified JSON configuration to your MCP setup. For CLI, install the package globally and then add the necessary configuration.

Key features of the Chinese Traditional Almanac MCP Service?

Supports conversion between Gregorian and Lunar calendars.
Provides daily auspicious and inauspicious activities.
Offers information on the twelve double-hour periods.
Includes detailed information about Five Elements, Gods, Stars, etc.

Use cases of the Chinese Traditional Almanac MCP Service?

Determining auspicious dates for important events.
Planning activities based on traditional calendar recommendations.
Understanding cultural significance of specific dates and times.

FAQ from the Chinese Traditional Almanac MCP Service?

Can this service provide information for any date?

Yes! The service can provide almanac information for any specified date.

Is there a cost to use the service?

The service is free to use for everyone.

How accurate is the information provided?

The information is based on traditional Chinese calendar calculations and is designed to be accurate.

Content

通胜 MCP 服务

简体中文 | English

中国传统黄历（通胜）计算服务，基于 Model Context Protocol (MCP)

✨ 功能特点

📅 公历农历转换 - 支持公历与农历日期的相互转换
🍀 每日宜忌 - 提供每日吉凶、宜忌活动的详细信息
🕐 时辰信息 - 十二时辰（子、丑、寅等）的吉凶宜忌
🔮 命理元素 - 五行、神煞、星宿等传统命理学详细数据

🚀 安装与使用

在你的 MCP 配置文件中添加以下内容：

{
  "mcpServers": {
    "tung-shing": {
      "command": "npx",
      "args": ["-y", "mcp-tung-shing@latest"]
    }
  }
}

⚙️ 工具

get-tung-shing

获取指定日期的黄历信息

参数:

参数名	类型	必填	默认值	描述
`startDate`	string	否	当天	开始日期，格式："YYYY-MM-DD"
`days`	number	否	1	获取天数
`includeHours`	boolean	否	false	是否包含时辰信息
`tabooFilters`	array	否	-	筛选宜忌事项类型，条件之间为或关系
`tabooFilters[].type`	1 \| 2	是	-	过滤类型：宜(1)、忌(2)
`tabooFilters[].value`	string	是	-	要筛选的宜忌事项