Bazi MCP

前置需求 ｜ Prerequisite

Node.js 22 版本或以上。

Node.js 22 or above.

开始使用 ｜ Start

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

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

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

Installing via Smithery

To install bazi-mcp for Claude Desktop automatically via Smithery:

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

工具列表 | Tools

buildBaziFromLunarDatetime

根据农历时间计算八字结果。
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

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

参数 ｜ Arguments

• lunarDatetime: 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.

八字结果 | Bazi result

工具返回的八字结果实例：

Example of the result returned from MCP server:

{
  "性别": "男",
  "阳历": "1998年7月31日 14:10:00",
  "农历": "农历戊寅年六月初九辛未时",
  "年柱": {
    "天干": {
      "天干": "戊",
      "五行": "土",
      "阴阳": "阳",
      "十神": "劫财"
    },
    "地支": {
      "地支": "寅",
      "五行": "木",
      "阴阳": "阳",
      "藏干": {
        "主气": {
          "天干": "甲",
          "十神": "正官"
        },
        "中气": {
          "天干": "丙",
          "十神": "正印"
        },
        "余气": {
          "天干": "戊",
          "十神": "劫财"
        }
      }
    },
    "纳音": "城头土",
    "旬": "甲戌",
    "空亡": "申酉",
    "星运": "死",
    "自坐": "长生"
  },
  "月柱": {
    "天干": {
      "天干": "己",
      "五行": "土",
      "阴阳": "阴",
      "十神": "比肩"
    },
    "地支": {
      "地支": "未",
      "五行": "土",
      "阴阳": "阴",
      "藏干": {
        "主气": {
          "天干": "己",
          "十神": "比肩"
        },
        "中气": {
          "天干": "丁",
          "十神": "偏印"
        },
        "余气": {
          "天干": "乙",
          "十神": "七杀"
        }
      }
    },
    "纳音": "天上火",
    "旬": "甲寅",
    "空亡": "子丑",
    "星运": "冠带",
    "自坐": "冠带"
  },
  "日柱": {
    "天干": {
      "天干": "己",
      "五行": "土",
      "阴阳": "阴"
    },
    "地支": {
      "地支": "卯",
      "五行": "木",
      "阴阳": "阴",
      "藏干": {
        "主气": {
          "天干": "乙",
          "十神": "七杀"
        }
      }
    },
    "纳音": "城头土",
    "旬": "甲戌",
    "空亡": "申酉",
    "星运": "病",
    "自坐": "病"
  },
  "时柱": {
    "天干": {
      "天干": "辛",
      "五行": "金",
      "阴阳": "阴",
      "十神": "食神"
    },
    "地支": {
      "地支": "未",
      "五行": "土",
      "阴阳": "阴",
      "藏干": {
        "主气": {
          "天干": "己",
          "十神": "比肩"
        },
        "中气": {
          "天干": "丁",
          "十神": "偏印"
        },
        "余气": {
          "天干": "乙",
          "十神": "七杀"
        }
      }
    },
    "纳音": "路旁土",
    "旬": "甲子",
    "空亡": "戌亥",
    "星运": "冠带",
    "自坐": "衰"
  },
  "胎元": "庚戌",
  "胎息": "甲戌",
  "命宫": "乙卯",
  "身宫": "乙卯",
  "神煞": {
    "年柱": ["国印", "亡神"],
    "月柱": ["天德合", "月德合", "金舆", "太极贵人", "福星贵人", "血刃", "华盖", "天喜", "元辰"],
    "日柱": ["天德合", "月德合", "桃花", "九丑", "童子煞"],
    "时柱": ["金舆", "太极贵人", "福星贵人", "血刃", "华盖", "天喜", "元辰", "童子煞"]
  },
  "大运": {
    "起运日期": "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
      }
    ]
  },
  "刑冲合会": {
    "年": {
      "天干": {},
      "地支": {}
    },
    "月": {
      "天干": {},
      "地支": {
        "半合": [
          {
            "柱": "日",
            "知识点": "未卯半合木",
            "元素": "木"
          }
        ]
      }
    },
    "日": {
      "天干": {},
      "地支": {
        "半合": [
          {
            "柱": "月",
            "知识点": "卯未半合木",
            "元素": "木"
          },
          {
            "柱": "时",
            "知识点": "卯未半合木",
            "元素": "木"
          }
        ]
      }
    },
    "时": {
      "天干": {},
      "地支": {
        "半合": [
          {
            "柱": "日",
            "知识点": "未卯半合木",
            "元素": "木"
          }
        ]
      }
    }
  }
}

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