Bazi MCP

What cantian-ai/bazi-mcp MCP server does

cantian-ai/bazi-mcp MCP server exposes Bazi calculation and calendar functions to MCP-compatible AI applications. Bazi, also known as the Four Pillars system, uses birth date and time information to produce a structured chart. The server is listed in the Spirituality & Esoterica category and is intended for applications involving Chinese astrology, metaphysics, chart interpretation, and related research.

The main charting operation accepts either a solar-calendar datetime or a lunar datetime. It returns the four pillars and associated details, including heavenly stems, earthly branches, elemental attributes, yin-yang classifications, hidden stems, ten gods, na yin, empty branches, star positions, and self-seated states. Results can also include the fetal origin, fetal breath, life palace, body palace, auxiliary stars, major fortune periods, and pillar relationships such as combinations or partial combinations.

How it works

The server can run through stdio or Streamable HTTP. For stdio, an MCP client launches the package with npx bazi-mcp. The README gives Claude Desktop as an example client and also documents an npm start command for Streamable HTTP.

getBaziDetail calculates a chart from an ISO solar datetime, a lunar datetime, or both according to the request. Gender is optional, with numeric values for female and male and male as the default. The eightCharProviderSect option controls how the late-night period from 23:00 to 23:59 is assigned to the current or following day.

getSolarTimes takes a space-separated Bazi string and returns possible solar-calendar datetimes. This supports workflows that start with known pillars and need candidate dates. getChineseCalendar returns Chinese calendar information for a supplied solar datetime, or for the current day when no date is specified.

Setup and configuration

cantian-ai/bazi-mcp MCP server requires Node.js 22 or newer. A stdio configuration can use the following structure:

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

The repository also documents installation through Smithery for Claude Desktop. That installation uses the Smithery CLI and targets the @cantian-ai/bazi-mcp package.

Tools and capabilities

• getBaziDetail: Calculates detailed Bazi results from solar or lunar datetime input.
• getSolarTimes: Returns possible solar datetimes for a supplied Bazi.
• getChineseCalendar: Retrieves Chinese calendar information for a selected solar date or the default current date.

The returned chart data is structured for downstream agent analysis rather than limited to a single formatted interpretation. Developers can use the fields to build prompts, display chart components, or implement application-specific Bazi analysis.

Limitations and notes

Applications should validate datetime formats before calling the tools.