MCP Directory

Bazi MCP (八字 MCP)

AI-powered Bazi (Chinese Four Pillars) calculator for accurate destiny and personality data.

Unverified
stdio (local)
No auth
Stale
TypeScript
View repo 393 Website npm

Add to your client

Copy the config for your MCP client and paste it into its config file.

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

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

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

Before you start

  • Node.js 22 or above

About Bazi MCP (八字 MCP)

Bazi MCP is the first AI-powered Bazi (八字 / Chinese Four Pillars of Destiny) calculator delivered as an MCP server. It gives AI agents accurate Bazi chart data — pillars, hidden stems, ten gods, na yin, fortune-luck cycles (大运), shensha (神煞), and clash/combine relationships — plus reverse Bazi-to-date lookup and Chinese almanac (黄历) information. It is designed to fix the chart-casting errors that general-purpose LLMs frequently make for Chinese metaphysics tasks.

Tools & capabilities (3)

getBaziDetail

Calculate full Bazi (Four Pillars) results from a solar or lunar datetime. Args: solarDatetime (ISO, e.g. 2000-05-15T12:00:00+08:00), lunarDatetime (e.g. 2000-05-15 12:00:00), gender (0=female, 1=male; default 1), eightCharProviderSect (1 or 2; controls whether the 23:00-23:59 day stem belongs to tomorrow or today; default 2). Returns pillars with stems/branches, five elements, ten gods, hidden stems, na yin, void (空亡), fortune-luck cycles (大运), shensha (神煞), and clash/combine relations.

getSolarTimes

Return a list of possible solar-calendar datetimes that correspond to a given Bazi. Arg: bazi (String, the four pillars separated by spaces).

getChineseCalendar

Get Chinese almanac (黄历) information for a specified solar date (defaults to today). Arg: solarDatetime (ISO format, e.g. 2000-05-15T12:00:00+08:00). Returns lunar date, ganzhi, zodiac, na yin, solar term, 28 mansions, lucky directions, clash/sha, and auspicious/inauspicious activities (宜/忌).

When to use it

  • Power AI fortune-telling and personality-analysis agents with accurate Bazi chart data
  • Compute a person's Four Pillars chart from their birth date and time
  • Look up auspicious dates and almanac (黄历) details for a given day
  • Reverse-engineer candidate birth datetimes from a known Bazi

Bazi MCP (八字 MCP) FAQ

What transports does the server support?

Both Streamable HTTP (started with `npm start`) and stdio. For stdio, configure your AI app to launch it via `npx bazi-mcp`.

Does it require an API key?

No. The documented stdio configuration runs the server locally via npx with no authentication or environment variables.

Can I install it automatically?

Yes. It can be installed for Claude Desktop via Smithery: `npx -y @smithery/cli install @cantian-ai/bazi-mcp --client claude`.

#bazi#chinese-astrology#fortune-telling#metaphysics#calendar#destiny#cantian-ai

Alternatives to Bazi MCP (八字 MCP)

Task Master AI
Productivity
28k

AI-powered task-management system for AI-driven development that drops into Cursor, Windsurf, Claude Code, and more.

Unverified
stdio (local)
API key
JavaScript
15 tools
Updated 3 months agoRepo
n8n-MCP
Productivity
22k

Gives AI assistants deep knowledge of 2,000+ n8n nodes, plus optional workflow management on your own n8n instance.

Unverified
stdio (local)
API key
TypeScript
22 tools
Updated 1 month agoRepo
Cua Driver
Productivity
19k

Background computer-use MCP server that drives native macOS, Windows, and Linux desktop apps without stealing focus.

Unverified
stdio (local)
No auth
Rust
33 tools
Updated 1 month agoRepo

Compare Bazi MCP (八字 MCP) with:

vs Task Master AIvs n8n-MCPvs Cua Drivervs mcp-atlassian (community Jira/Confluence)