Happy slice of mcp pizzaMCP.pizza
Fire in da houseTop Tip:Paying $100+ per month for Perplexity, MidJourney, Runway, ChatGPT and other tools is crazy - get all your AI tools in one site starting at $15 per month with Galaxy AI Fire in da houseCheck it out free

mcp-tung-shing

MCP.Pizza Chef: baranwang

mcp-tung-shing is a Model Context Protocol (MCP) server providing Chinese traditional almanac (Tung Shing) data. It offers lunar and solar calendar conversions, daily auspicious and inauspicious activities, detailed time period (shichen) information, and traditional metaphysical elements like five elements, deities, and constellations. This server enables applications to integrate rich Chinese calendrical and fortune-telling data for cultural, planning, or astrological use cases.

Use This MCP server To

Convert Gregorian dates to Chinese lunar calendar dates Retrieve daily auspicious and inauspicious activities Get detailed twelve time periods (shichen) fortune information Access traditional metaphysical data like five elements and star constellations Integrate Chinese almanac data into scheduling or planning apps Provide cultural context for events based on traditional Chinese calendar

README

通胜 MCP 服务

smithery badge NPM Version License

简体中文 | 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 是 - 要筛选的宜忌事项

🤝 贡献

欢迎提交 Issues 和 Pull Requests 来完善此项目。

mcp-tung-shing FAQ

How do I install the mcp-tung-shing server?
Add it to your MCP config with the command 'npx -y mcp-tung-shing@latest' as shown in the README for easy setup.
What kind of date conversions does mcp-tung-shing support?
It supports conversions between the Gregorian (solar) calendar and the Chinese lunar calendar, essential for traditional date calculations.
Can I get daily auspicious and inauspicious activities from this server?
Yes, the server provides detailed daily recommendations on favorable and unfavorable activities based on traditional Chinese almanac data.
Does mcp-tung-shing provide information about the twelve Chinese time periods?
Yes, it includes fortune and auspiciousness details for each of the twelve shichen (time periods) like Zi, Chou, Yin, etc.
What traditional metaphysical elements are included?
The server offers data on the five elements (Wu Xing), deities (Shen Sha), and star constellations used in Chinese metaphysics.
Is the mcp-tung-shing server suitable for integrating cultural calendar data into apps?
Absolutely, it is designed to provide rich traditional Chinese calendrical data for apps needing cultural or astrological context.
What languages does the mcp-tung-shing server support?
The server and documentation support Simplified Chinese and English, making it accessible to a broad user base.