通胜 MCP 服务

什么是通胜 MCP 服务？

通胜 MCP 服务是一个基于 Model Context Protocol (MCP) 的中国传统黄历（通胜）计算服务，提供公历农历转换、每日宜忌、时辰信息及命理元素等功能。

如何用通胜 MCP 服务？

在 MCP 客户端配置文件中添加以下内容即可使用，无需额外安装其他依赖：

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

使用 get-tung-shing 工具获取指定日期的黄历信息，支持参数 startDate（格式 YYYY-MM-DD）、days（天数）、includeHours（是否包含时辰）和 tabooFilters（筛选宜忌事项类型）。

通胜 MCP 服务的核心功能

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

通胜 MCP 服务的应用场景

• 为个人择吉、婚嫁、开业等传统活动查询黄历信息
• 在日历或日程应用中集成农历显示和每日宜忌
• 为风水、命理研究提供自动化数据计算工具
• 结合AI助手提供即时的黄历咨询服务
• 批量查询多日或全年的黄历信息

通胜 MCP 服务的常见问题

通胜 MCP 服务的数据来源是什么？

服务使用内置算法计算中国传统黄历（通胜）数据，无需联网获取外部数据。

通胜 MCP 服务需要什么运行时环境？

服务以 npm 包形式发布，运行在 Node.js 环境下，通过 npx 命令可直接调用。

如何获取指定日期的时辰信息？

在调用 get-tung-shing 工具时设置 includeHours 参数为 true 即可返回包含十二时辰吉凶宜忌的详细信息。

是否支持筛选特定类型的宜忌事项？

支持。通过 tabooFilters 参数可以筛选宜（type: 1）或忌（type: 2）的具体事项，多个条件之间为或关系。

通胜 MCP 服务是否支持公历转农历？

是，get-tung-shing 工具返回的「农历日期」字段包含公历对应的农历日期信息。