Ba-Zi.ai Chinese Astrology
MCP server for BaZi charts, bone weight fortune and the Chinese almanac
- 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-skillAdd to claude_desktop_config.json
{
"mcpServers": {
"chinese-astrology-skill": {
"command": "npx",
"args": [
"-y",
"chinese-astrology-skill"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"chinese-astrology-skill": {
"command": "npx",
"args": [
"-y",
"chinese-astrology-skill"
]
}
}
}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.
