Skip to content
MCP server

Ba-Zi.ai Chinese Astrology

MCP server for BaZi charts, bone weight fortune and the Chinese almanac

Runs locally
Install
Pricing
Free
Platforms
CLI, self-hosted
Runs
Locally
Version
1.0.1
Listing updated
4 days ago

Similar MCP servers

About Ba-Zi.ai Chinese Astrology

Ba-Zi.ai Chinese Astrology is a free MCP server for astrology. It runs locally on your machine and is started by your AI client.

Built by Ba-Zi.ai, this npm package packages four calculation tools drawn from traditional Chinese astrology. The README says it uses the tyme4ts calendar library, and the bone weight tool follows the Yuan Tiangang method with 52 destiny poems and a modern interpretation. Tool descriptions are bilingual in English and Chinese.

getBaziChart takes a solar datetime and gender and returns the four pillars with ten gods, hidden stems, nayin, decade fortune and branch relations. findBirthDates works backwards from a BaZi string to matching dates since 1700. getAlmanac returns lunar date, solar terms, 28 mansions, directional gods and auspicious or inauspicious activities for a day.

It runs over stdio with npx, or as a local HTTP server after cloning the repository. The related Ba-Zi.ai website offers a free chart and AI readings, with paid reports; that is separate from this package.

Install

Run in a terminal

claude mcp add chinese-astrology-skill -- npx -y chinese-astrology-skill

Add to claude_desktop_config.json

{
  "mcpServers": {
    "chinese-astrology-skill": {
      "command": "npx",
      "args": [
        "-y",
        "chinese-astrology-skill"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "chinese-astrology-skill": {
      "command": "npx",
      "args": [
        "-y",
        "chinese-astrology-skill"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "chinese-astrology-skill": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "chinese-astrology-skill"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "chinese-astrology-skill": {
      "command": "npx",
      "args": [
        "-y",
        "chinese-astrology-skill"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "chinese-astrology-skill": {
      "command": "npx",
      "args": [
        "-y",
        "chinese-astrology-skill"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

getBaziChart
Calculate a full Four Pillars chart from a birth datetime.
findBirthDates
Find birth dates matching a BaZi string.
getAlmanac
Return Chinese almanac information for a date.
calculateBoneWeight
Calculate bone weight fortune with its poem.

What it does

Four Pillars chart
getBaziChart computes pillars, ten gods, hidden stems and decade fortune.
Reverse lookup
findBirthDates finds dates matching a BaZi string.
Chinese almanac
getAlmanac returns lunar date, solar terms and daily guidance.
Bone weight fortune
calculateBoneWeight returns a weight, breakdown and poem.
Bilingual descriptions
Tool descriptions appear in English and Chinese.
Stdio or HTTP
Run through npx or a local HTTP server.

Good for

  • Give a chatbot BaZi chart calculation
  • Look up the almanac for a date
  • Add bone weight readings to a fortune app
  • Find possible birth dates from a BaZi string

Pricing

Free

Package listed without environment variables or fees; the Ba-Zi.ai site sells separate paid reports

Prices change. Check ba-zi.ai before you buy.

Ba-Zi.ai Chinese Astrology FAQ

How do I run it?

Add npx -y chinese-astrology-skill to your MCP config, or run npx chinese-astrology-skill.

Does it need an API key?

No environment variables are listed for the package.

What does it use for calendar maths?

The README names the tyme4ts library.

Can it run over HTTP?

Yes, after cloning and npm start it serves at localhost port 3000 under /mcp.

Is Ba-Zi.ai Chinese Astrology free?

Yes. Ba-Zi.ai Chinese Astrology is free to use.

How do I add Ba-Zi.ai Chinese Astrology to Claude Code?

Run this command in your terminal: claude mcp add chinese-astrology-skill -- npx -y chinese-astrology-skill

What are the best alternatives to Ba-Zi.ai Chinese Astrology?

The closest alternatives to Ba-Zi.ai Chinese Astrology are BaziTools — True Solar Time BaZi Four Pillars & Classical Chinese Name Engine, BaziChart, Get Chinese Astrology, Wenbu · 问卜 and Ancient Echoes.

Where this comes from

  • Description: written from the project's README and the project's website.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers