About 通胜 MCP 服务
The Tung Shing MCP Service provides calculations for the Chinese traditional almanac, including conversion between Gregorian and lunar dates and daily auspicious and inauspicious activities. It suits users who need traditional almanac data.
Key features
- 01Gregorian and lunar date conversion
- 02Daily auspicious and inauspicious activities
- 03Hour-by-hour fortune for the twelve hours
- 04Five elements, spirits and star mansion data
- 05Filtering dates by taboo-related items
Use cases
- 01Looking up auspicious and inauspicious activities for a given date
- 02Filtering a date range by activities marked as suitable or unsuitable
MCP support
The service exposes a get-tung-shing tool that returns almanac information for a start date and day count, with options for hour details and activity filters.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
1Saved tool list · updated 3w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| startDate | string | No | Start date, as a string in the format "YYYY-MM-DD" |
| days | any | No | Number of consecutive days to retrieve |
| includeHours | boolean | No | Whether to include time-of-day information |
| tabooFilters | array | No | Multiple auspicious/inauspicious activity filters, with OR logic between conditions |
Details
From the project README通胜 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 | 是 | - | 要筛选的宜忌事项 |
🤝 贡献
欢迎提交 Issues 和 Pull Requests 来完善此项目。
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.