Bazi MCP (八字 MCP) by Cantian AI

通过Bazi MCP解锁精准的八字洞察，这是首个基于AI的八字计算器。为了解决现有AI算命工具如GPT和DeepSeek中的不准确性问题，我们的MCP提供了可靠的八字数据，用于性格分析、命运预测等。

为什么选择Bazi MCP？

• 精准的八字计算：提供深刻的八字信息。
• AI代理集成：为AI代理提供精确的八字数据。
• 社区驱动：加入爱好者行列，推动中国玄学的发展。

该项目源自GPT Store中热门的Chinese Bazi Fortune Teller，现已与参天 AI (cantian.ai) 整合。我们邀请八字从业者和AI爱好者合作，分享见解，并贡献于我们的开源社区。

参与进来

• 联系：support@cantian.ai

中文

八字 MCP是参天 AI 推出的首个面向玄学领域的 MCP，针对 GPT 和 DeepSeek 等算命工具常出现的排盘错误，提供精准的八字数据，助力性格分析、命运预测等应用。

八字 MCP 亮点

• 精准排盘：提供全面的八字排盘信息。
• AI 赋能：为 AI 智能体提供可靠八字服务。
• 社区共建：欢迎命理爱好者参与交流与开发。

项目源于 GPT Store 热门应用Chinese Bazi Fortune Teller，现已融入参天 AI平台 (cantian.ai)。我们诚邀命理研究者与 AI 开发者加入，共同推动中国传统文化的传承与创新。

联系我们

• 邮箱：support@cantian.ai

• 微信：

前置需求 ｜ Prerequisite

Node.js 22 版本或以上。

Node.js 22 or above.

开始使用 ｜ Start

配置 AI 应用（例如 Claude Desktop）。

Configure AI application (e.g. Claude Desktop).

json
{
"mcpServers": {
"Bazi": {
"command": "npx",
"args": ["bazi-mcp"]
}
}
}

通过 Smithery 安装

要通过 Smithery 自动安装 bazi-mcp 到 Claude Desktop：

bash
npx -y @smithery/cli install @cantian-ai/bazi-mcp --client claude

工具列表 | Tools

getBaziDetail

根据给定的公历或农历时间计算八字信息。
Calculate the Bazi results based on the solar/lunar datetime.

参数 | Arguments

• solarDatetime: String

  ISO 格式的阳历时间。例如：2000-05-15T12:00:00+08:00。
  Solar datetime in ISO format. Example: 2000-05-15T12:00:00+08:00.

• lunarDatetime: String

  农历时间。例如：2000-05-15 12:00:00。
  Lunar datetime. Example: 2000-05-15 12:00:00.

• gender: Number

  性别。可选。0 - 女，1-男。默认 1。
  Gender. Optional. 0 for female, 1 for male. 1 by default.

• eightCharProviderSect： Number

  早晚子时配置。可选。1 - 表示 23:00-23:59 日干支为明天，2 - 表示 23:00-23:59 日干支为当天。默认 2。
  Configuration for eight char provider. Optional. 1 for meaning the day stem of 23:00-23:59 is for tomorrow, 2 for meaning the day stem of 23:00-23:59 is for today. 2 by default.

结果示例 ｜ Result example

json
{
"性别": "男",
"阳历": "1998年7月31日 14:10:00",
"农历": "农历戊寅年六月初九辛未时",
"八字": "戊寅 己未 己卯 辛未",
"生肖": "虎",
"日主": "己",
"年柱": {
"天干": {
"天干": "戊",
"五行": "土",
"阴阳": "阳",
"十神": "劫财"
},
"地支": {
"地支": "寅",
"五行": "木",
"阴阳": "阳",
"藏干": {
"主气": {
"天干": "甲",
"十神": "正官"
},
"中气": {
"天干": "丙",
"十神": "正印"
},
"余气": {
"天干": "戊",
"十神": "劫财"
}
}
},
"纳音": "城头土",
"旬": "甲戌",
"空亡": "申酉",
"星运": "死",
"自坐": "长生"
},
"月柱": {
"天干": {
"天干": "己",
"五行": "土",
"阴阳": "阴",
"十神": "比肩"
},
"地支": {
"地支": "未",
"五行": "土",
"阴阳": "阴",
"藏干": {
"主气": {
"天干": "己",
"十神": "比肩"
},
"中气": {
"天干": "丁",
"十神": "偏印"
},
"余气": {
"天干": "乙",
"十神": "七杀"
}
}
},
"纳音": "天上火",
"旬": "甲寅",
"空亡": "子丑",
"星运": "冠带",
"自坐": "冠带"
},
"日柱": {
"天干": {
"天干": "己",
"五行": "土",
"阴阳": "阴"
},
"地支": {
"地支": "卯",
"五行": "木",
"阴阳": "阴",
"藏干": {
"主气": {
"天干": "乙",
"十神": "七杀"
}
}
},
"纳音": "城头土",
"旬": "甲戌",
"空亡": "申酉",
"星运": "病",
"自坐": "病"
},
"时柱": {
"天干": {
"天干": "辛",
"五行": "金",
"阴阳": "阴",
"十神": "食神"
},
"地支": {
"地支": "未",
"五行": "土",
"阴阳": "阴",
"藏干": {
"主气": {
"天干": "己",
"十神": "比肩"
},
"中气": {
"天干": "丁",
"十神": "偏印"
},
"余气": {
"天干": "乙",
"十神": "七杀"
}
}
},
"纳音": "路旁土",
"旬": "甲子",
"空亡": "戌亥",
"星运": "冠带",
"自坐": "衰"
},
"胎元": "庚戌",
"胎息": "甲戌",
"命宫": "乙卯",
"身宫": "乙卯",
"神煞": {
"年柱": ["国印", "亡神"],
"月柱": ["天德合", "月德合", "天乙贵人", "太极贵人", "福星贵人", "金舆", "血刃", "华盖", "天喜", "元辰"],
"日柱": ["天德合", "月德合", "桃花", "九丑", "童子煞"],
"时柱": ["天乙贵人", "太极贵人", "福星贵人", "金舆", "血刃", "华盖", "天喜", "元辰", "童子煞"]
},
"大运": {
"起运年龄": 4,
"起运日期": "2001-1-26",
"大运": [
{
"干支": "庚申",
"开始年份": 2001,
"结束": 2010,
"天干十神": "伤官",
"地支十神": ["伤官", "正财", "劫财"],
"地支藏干": ["庚", "壬", "戊"],
"开始年龄": 4,
"结束年龄": 13
},
{
"干支": "辛酉",
"开始年份": 2011,
"结束": 2020,
"天干十神": "食神",
"地支十神": ["食神"],
"地支藏干": ["辛"],
"开始年龄": 14,
"结束年龄": 23
},
{
"干支": "壬戌",
"开始年份": 2021,
"结束": 2030,
"天干十神": "正财",
"地支十神": ["劫财", "食神", "偏印"],
"地支藏干": ["戊", "辛", "丁"],
"开始年龄": 24,
"结束年龄": 33
},
{
"干支": "癸亥",
"开始年份": 2031,
"结束": 2040,
"天干十神": "偏财",
"地支十神": ["正财", "正官"],
"地支藏干": ["壬", "甲"],
"开始年龄": 34,
"结束年龄": 43
},
{
"干支": "甲子",
"开始年份": 2041,
"结束": 2050,
"天干十神": "正官",
"地支十神": ["偏财"],
"地支藏干": ["癸"],
"开始年龄": 44,
"结束年龄": 53
},
{
"干支": "乙丑",
"开始年份": 2051,
"结束": 2060,
"天干十神": "七杀",
"地支十神": ["比肩", "偏财", "食神"],
"地支藏干": ["己", "癸", "辛"],
"开始年龄": 54,
"结束年龄": 63
},
{
"干支": "丙寅",
"开始年份": 2061,
"结束": 2070,
"天干十神": "正印",
"地支十神": ["正官", "正印", "劫财"],
"地支藏干": ["甲", "丙", "戊"],
"开始年龄": 64,
"结束年龄": 73
},
{
"干支": "丁卯",
"开始年份": 2071,
"结束": 2080,
"天干十神": "偏印",
"地支十神": ["七杀"],
"地支藏干": ["乙"],
"开始年龄": 74,
"结束年龄": 83
},
{
"干支": "戊辰",
"开始年份": 2081,
"结束": 2090,
"天干十神": "劫财",
"地支十神": ["劫财", "七杀", "偏财"],
"地支藏干": ["戊", "乙", "癸"],
"开始年龄": 84,
"结束年龄": 93
},
{
"干支": "己巳",
"开始年份": 2091,
"结束": 2100,
"天干十神": "比肩",
"地支十神": ["正印", "伤官", "劫财"],
"地支藏干": ["丙", "庚", "戊"],
"开始年龄": 94,
"结束年龄": 103
}
]
},
"刑冲合会": {
"年": {
"天干": {},
"地支": {}
},
"月": {
"天干": {},
"地支": {
"半合": [
{
"柱": "日",
"知识点": "未卯半合木",
"元素": "木"
}
]
}
},
"日": {
"天干": {},
"地支": {
"半合": [
{
"柱": "月",
"知识点": "卯未半合木",
"元素": "木"
},
{
"柱": "时",
"知识点": "卯未半合木",
"元素": "木"
}
]
}
},
"时": {
"天干": {},
"地支": {
"半合": [
{
"柱": "日",
"知识点": "未卯半合木",
"元素": "木"
}
]
}
}
}
}### getSolarTimes

根据给定的八字返回可能的公历时间列表。
Return a list of possible solar calendar datetime based on the given Bazi.

参数 | Arguments

• bazi: String

  八字，各柱用空格隔开。
  Bazi, with each pillar separated by a space.

结果示例 ｜ Result example

json
["1758-07-29 14:00:00", "1818-07-15 14:00:00", "1998-07-31 14:00:00"]

getChineseCalendar

获取指定公历时间（默认今天）的黄历信息。
Get chinese calendar information for the specified solar calendar date (default is today).

参数 | Arguments

• solarDatetime

  ISO 格式的阳历时间。例如：2000-05-15T12:00:00+08:00。
  Solar datetime in ISO format. Example: 2000-05-15T12:00:00+08:00.

结果示例 ｜ Result example

json
{
"公历": "2025年5月7日 星期三",
"农历": "农历乙巳年四月初十",
"干支": "乙巳 辛巳 丙子",
"生肖": "蛇",
"纳音": "涧下水",
"节气": "立夏",
"二十八宿": "箕水豹吉",
"彭祖百忌": "丙不修灶必见灾殃 子不问卜自惹祸殃",
"喜神方位": "西南",
"阳贵神方位": "西",
"阴贵神方位": "西北",
"福神方位": "东",
"财神方位": "西南",
"冲煞": "冲马(午)煞南",
"宜": "嫁娶,祭祀,祈福,求嗣,开光,出行,拆卸,动土,上梁,出火,进人口,入宅,移徙,安床,栽种,纳畜,牧养,竖柱,安门,修造,解除,会亲友",
"忌": ""
}

~~buildBaziFromLunarDatetime~~ (deprecated)

根据农历时间计算八字结果。
Calculate the BaZi results based on the lunar datetime.

参数 ｜ Arguments

• lunarDatetime: String

  农历时间。例如：2000-05-15 12:00:00。
  Lunar datetime. Example: 2000-05-15 12:00:00.

• gender: Number

  性别。可选。0 - 女，1-男。默认 1。
  Gender. Optional. 0 for female, 1 for male. 1 by default.

• eightCharProviderSect： Number

  早晚子时配置。可选。1 - 表示 23:00-23:59 日干支为明天，2 - 表示 23:00-23:59 日干支为当天。默认 2。
  Configuration for eight char provider. Optional. 1 for meaning the day stem of 23:00-23:59 is for tomorrow, 2 for meaning the day stem of 23:00-23:59 is for today. 2 by default.

~~buildBaziFromSolarDatetime~~ (deprecated)

根据阳历时间计算八字结果。
Calculate the BaZi results based on the solar datetime.

参数 ｜ Arguments

• solarDatetime: String

  ISO 格式的阳历时间。例如：2000-05-15T12:00:00+08:00。
  Solar datetime in ISO format. Example: 2000-05-15T12:00:00+08:00.

• gender: Number

  性别。可选。0 - 女，1-男。
  Gender. Optional. 0 for female, 1 for male.

• eightCharProviderSect： Number

  早晚子时配置。可选。1 - 表示 23:00-23:59 日干支为明天，2 - 表示 23:00-23:59 日干支为当天。默认 2。
  Configuration for eight char provider. Optional. 1 for meaning the day stem of 23:00-23:59 is for tomorrow, 2 for meaning the day stem of 23:00-23:59 is for today. 2 by default.

Keywords: Bazi MCP, Bazi AI Agent, Fengshui AI Agent, Bazi Calculator MCP, Bazi Calculator AI, Cantian AI