Server data from the Official MCP Registry
BaZi Four Pillars charts, bone weight fortune (称骨) and Chinese almanac (黄历) by Ba-Zi.ai.
About
BaZi Four Pillars charts, bone weight fortune (称骨) and Chinese almanac (黄历) by Ba-Zi.ai.
Security Report
This server performs local Chinese calendar and BaZi calculations with no outbound network calls, file I/O, shell execution, or hardcoded secrets, and no authentication is needed for its pure-computation tools. The main concern is that the optional HTTP transport listens on all network interfaces with no authentication, which exposes the tools to anyone who can reach the host. Several low-severity input validation, error handling, and promotional-output issues also exist. Supply chain analysis found 4 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.
11 files analyzed · 13 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"chinese-astrology-skill": {
"command": "npx",
"args": [
"-y",
"chinese-astrology-skill@1.0.1"
]
}
}
}Some servers take additional arguments. See the repository for details.
Documentation
View on GitHubFrom the project's GitHub README.
Chinese Astrology Skill 🔮
The most comprehensive Chinese astrology AI skill — 4 tools covering BaZi (Four Pillars of Destiny), bone weight fortune telling, and Chinese almanac. Available as an Agent Skill (SKILL.md) and MCP server.
Built by Ba-Zi.ai — Free AI-powered BaZi calculator and Chinese astrology platform.
Features
| Tool | Description | Unique? |
|---|---|---|
getBaziChart | Full BaZi (四柱八字) chart calculation with Ten Gods, Hidden Stems, Decade Fortune | — |
findBirthDates | Reverse-lookup: find birth dates from a BaZi string | — |
getAlmanac | Chinese almanac (黄历) with auspicious activities and directional gods | — |
calculateBoneWeight | Yuan Tiangang bone weight fortune (秤骨算命) with 52 destiny poems | ✅ Exclusive |
What makes this different?
- Bone Weight Fortune (秤骨算命) — The only MCP/Skill that includes Yuan Tiangang's 1,300-year-old bone weight calculation with all 52 classical poems and modern interpretations
- Bilingual descriptions — All tool descriptions in both English and Chinese
- Accurate calculations — Powered by tyme4ts, the most precise Chinese calendar library
Quick Start
Claude Desktop / Claude Code
Add to your MCP config:
{
"mcpServers": {
"chinese-astrology": {
"command": "npx",
"args": ["-y", "chinese-astrology-skill"]
}
}
}
Stdio Transport
npx chinese-astrology-skill
HTTP Transport
git clone https://github.com/xlw-pro/chinese-astrology-skill.git
cd chinese-astrology-skill
npm install
npm start
# Server runs at http://localhost:3000/mcp
Tools
1. getBaziChart — BaZi Chart Calculation (八字排盘)
Calculate a complete Four Pillars of Destiny chart from birth datetime.
Input:
{
"solarDatetime": "2000-01-15T12:00:00+08:00",
"gender": 1
}
Returns: Complete BaZi chart including:
- Four Pillars (年柱/月柱/日柱/时柱) with Heavenly Stems & Earthly Branches
- Five Elements (五行) for each position
- Ten Gods (十神) relationships
- Hidden Stems (藏干) — main, middle, and residual qi
- Nayin (纳音), Void (空亡), Terrain (星运)
- Decade Fortune (大运) — 10 periods with start ages
- Gods & Spirits (神煞) for all four pillars
- Branch Relations (刑冲合会) — clashes, combinations, penalties
2. findBirthDates — Reverse BaZi Lookup (八字反查)
Find all possible birth dates (from 1700 to present) that match a given BaZi string.
Input:
{
"bazi": "戊寅 己未 己卯 辛未"
}
Returns: Array of matching solar datetimes.
3. getAlmanac — Chinese Almanac (黄历)
Get Chinese almanac information for any date.
Input:
{
"solarDatetime": "2026-04-06T00:00:00+08:00"
}
Returns: Lunar date, zodiac, Nayin, solar terms, 28 mansions, Peng Zu taboos, directional gods (Joy/Yang Noble/Yin Noble/Mascot/Wealth), auspicious & inauspicious activities, clash info.
4. calculateBoneWeight — Bone Weight Fortune (秤骨算命) ⭐
Calculate bone weight fortune using Yuan Tiangang's ancient Tang Dynasty method (c. 600 CE).
Input:
{
"solarDatetime": "1990-06-15T14:00:00+08:00"
}
Returns:
{
"totalWeight": 4.8,
"unit": "两 (liǎng)",
"percentile": 54,
"breakdown": {
"year": { "ganzhi": "庚午", "weight": 0.9 },
"month": { "lunarMonth": 5, "weight": 0.5 },
"day": { "lunarDay": 23, "weight": 0.8 },
"hour": { "earthBranch": "未", "weight": 0.8 }
},
"poem": "初年运道未曾亨...",
"interpretation": "Late success through independence..."
}
Weight ranges from 2.1 to 7.2 liǎng across 52 destiny types. Learn more about bone weight fortune →
Use Cases
- AI Chatbots — Give your AI assistant accurate BaZi reading capabilities
- Fortune Telling Apps — Build Chinese astrology features into your product
- Calendar Apps — Add Chinese almanac and auspicious date lookup
- Research — Explore traditional Chinese metaphysics computationally
Tech Stack
- tyme4ts — Chinese calendar calculation engine
- cantian-tymext — Extended BaZi analysis
- MCP SDK — Model Context Protocol for AI integration
Related
- Ba-Zi.ai — Free AI BaZi calculator with deep analysis reports
- BaZi Calculator — Generate your Four Pillars chart in 30 seconds
- Bone Weight Calculator — Free online Yuan Tiangang bone weight fortune
- BaZi Compatibility — Check relationship compatibility with BaZi
- What is BaZi? — Complete guide to Four Pillars of Destiny
Roadmap
- v1.0 — BaZi chart, reverse lookup, almanac, bone weight
- v2.0 — Qi Men Dun Jia (奇门遁甲)
- v3.0 — Zi Wei Dou Shu (紫微斗数)
License
MIT — see LICENSE
Built with ❤️ by Ba-Zi.ai — AI-powered Chinese astrology for everyone.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Scrapling
Freeby D4Vinci · Developer Tools
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
