八字 MCP 是由参天 AI 推出的首个面向中国传统玄学领域的 MCP (Microservices Communication Protocol)，旨在提供高度精准的八字排盘计算服务。它专门针对当前一些通用型 AI 工具（如 GPT 和 DeepSeek）在进行八字相关计算时出现的排盘错误问题，致力于为用户及下游 AI 应用提供可靠的基础数据，从而更好地支持性格分析、命运预测等多样化应用。
八字 MCP 具备以下核心亮点：
* 精准排盘： 能够根据输入的出生时间提供全面且准确的八字及相关命理信息，解决现有工具的计算误差问题。
* AI 赋能： 设计为可为 AI 智能体提供标准、可靠的八字数据接口，让 AI 能够基于准确的命理信息进行更专业的分析和服务。
* 社区共建： 项目采取开源模式，积极欢迎广大命理爱好者和 AI 开发者参与交流、贡献智慧，共同推动中国传统文化与现代技术的融合发展。
八字 MCP 项目起源于在 GPT Store 上受到广泛欢迎的“Chinese Bazi Fortune Teller”应用。目前，该项目已正式融入参天 AI 平台 (cantian.ai)，并作为一个开放社区项目运营。我们诚挚地邀请对中国命理学有深入研究的专家以及对 AI 技术和开源协作感兴趣的开发者加入，共同分享经验，完善功能。
要开始使用八字 MCP，需要满足以下前置需求：
* 安装 Node.js 22 版本或以上。
开始使用步骤（以配置 AI 应用为例）：
对于支持 MCP 的 AI 应用（例如 Claude Desktop），您需要进行相应的配置。在应用的配置中添加如下的 mcpServers 片段，指定运行八字 MCP 的命令：json
{
"mcpServers": {
"Bazi": {
"command": "npx",
"args": [
"bazi-mcp"
]
}
}
}
此外，也可以通过 Smithery 工具便捷地进行安装和客户端集成。例如，为 Claude Desktop 安装 bazi-mcp，可以运行以下命令：npx -y @smithery/cli install @cantian-ai/bazi-mcp --client claude
工具列表
八字 MCP 目前提供了一个核心工具：getBaziDetail。
- getBaziDetail
- 功能描述： 根据给定的公历或农历时间计算出对应的八字信息及相关的命理参数。
- 参数 | Arguments：
solarDatetime: String(可选，与lunarDatetime二选一): ISO 格式的阳历时间字符串。示例：2000-05-15T12:00:00+08:00。lunarDatetime: String(可选，与solarDatetime二选一): 农历时间字符串。示例：2000-05-15 12:00:00。gender: Number(可选): 性别。0 表示女性，1 表示男性。默认为 1 (男性)。eightCharProviderSect：Number(可选): 关于晚子时 (23:00-23:59) 日干支的处理方式配置。1 表示晚子时计入第二天的日干支；2 表示晚子时计入当天的日干支。默认为 2。
- 结果示例 | Result example：
调用此工具将返回一个包含详细八字信息的 JSON 对象，其中包括但不限于：性别、阳历和农历出生时间、四柱干支（年、月、日、时）、生肖、日主、各柱的天干地支信息（含五行、阴阳、十神、藏干）、纳音、旬、空亡、星运、自坐十二长生、胎元、胎息、命宫、身宫、神煞列表，以及详细的大运信息（包含起运日期、各步大运的干支、开始/结束年份、对应的天干十神、地支十神、地支藏干、开始/结束年龄等）。返回的 JSON 结构层层嵌套，提供了进行深度命理分析所需的各项数据。
如果您对项目感兴趣、有疑问或希望参与共建，可以通过以下方式联系我们：
* 邮箱：support@cantian.ai
* 微信：(详情请参考原始 README 或通过邮件获取)