Bazi MCP

To use Bazi MCP with an AI application that supports the Model Context Protocol (MCP) via Stdio (such as Claude Desktop), add the following configuration to your application's MCP settings file:

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

You can automatically install Bazi MCP for Claude Desktop using the Smithery CLI. This is the recommended method for automated setup.

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

To run the Bazi MCP server using the Streamable HTTP transport method, use the following command in your terminal:

npm start

Given a Bazi string, this tool returns a list of possible solar calendar datetimes that match those characters.

// Example arguments for getSolarTimes
{
  "bazi": "戊寅 己未 己卯 辛未"
}

Retrieve Chinese Almanac (Huangli) information for a specific solar calendar date. If no date is provided, it defaults to today. The result includes information such as the lunar date, stems and branches, zodiac sign, solar terms (Jieqi), auspicious directions, and daily 'do's and don'ts' (宜/忌).

// Example arguments for getChineseCalendar
{
  "solarDatetime": "2000-05-15T12:00:00+08:00"
}

Calculate detailed Bazi (Eight Characters) results based on either a solar (ISO format) or lunar datetime. The tool provides comprehensive data including the four pillars (Year, Month, Day, Hour), stems and branches, five elements, ten gods, life palaces, and major cycles (Da Yun).

// Example arguments for getBaziDetail
{
  "solarDatetime": "2000-05-15T12:00:00+08:00",
  "gender": 1,
  "eightCharProviderSect": 2
}

The getSolarTimes tool accepts the following argument:

• bazi (String): The Bazi string, with each pillar separated by a space.

The getChineseCalendar tool accepts the following argument:

• solarDatetime (String): Solar datetime in ISO format. Example: 2000-05-15T12:00:00+08:00.

The getBaziDetail tool accepts the following arguments:

• solarDatetime (String): Solar datetime in ISO format. Example: 2000-05-15T12:00:00+08:00.
• lunarDatetime (String): Lunar datetime. Example: 2000-05-15 12:00:00.
• gender (Number, Optional): Gender. 0 for female, 1 for male. Defaults to 1.
• eightCharProviderSect (Number, Optional): Configuration for the eight char provider regarding the late Zi hour (23:00-23:59). 1 means the day stem/branch is for tomorrow; 2 means it is for today. Defaults to 2.

Use buildBazi to generate a comprehensive Bazi (Eight Characters) profile. This function calculates the Four Pillars (Year, Month, Day, Hour), Zodiac, Day Master (日主), Fetal Origin (胎元), Fetal Breath (胎息), Life Palace (命宫), Body Palace (身宫), Shen Sha (神煞), Decade Fortune (大运), and Pillar Relations (刑冲合会).

Options

• lunarHour: A LunarHour object representing the birth time.
• eightCharProviderSect (optional): Determines the provider used for lunar hour calculations. Use 1 for DefaultEightCharProvider or 2 for LunarSect2EightCharProvider. Defaults to 2.
• gender (optional): The gender of the individual. Use 0 for Female or 1 for Male. Defaults to 1.

import { buildBazi } from './path-to-bazi';

const baziProfile = buildBazi({
  lunarHour: myLunarHourInstance,
  eightCharProviderSect: 2,
  gender: 1
});