Chinese Fortune Analysis System MCP (BaZi Fortune Project)

A fortune-teller system built on the Model Context Protocol (MCP).
This project supports solar/lunar date conversion, Four Pillars (BaZi) generation, Five Element analysis, Ten Gods deduction, and fortune interpretation. It is suitable for traditional fortune-telling applications, prediction platforms, and metaphysics-based SaaS products.

✨ Features

• 🧮 Four Pillars (BaZi) Generation: Converts birth date into Heavenly Stems and Earthly Branches (Year, Month, Day, Hour)
• 🔥 Five Element Analysis: Calculates the balance of Wood, Fire, Earth, Metal, and Water
• 🧙 Ten Gods Deduction: Derives relationships of each stem to the Day Master (Ri Zhu)
• 📈 Destiny Interpretation: Analyzes strength of the Day Master, favorable elements (Yong Shen), luck cycles (Da Yun), and annual fortune (Liu Nian)
• 📆 Chinese Age & Stem-Branch Year: Calculates Chinese virtual age and names the birth year (e.g., "Wu Zi Year")
• 🏮 Extended Modules: Ziwei Doushu, Auspicious Spirits (Shen Sha), Life Palace (Ming Gong), Body Palace (Shen Gong), etc.

▶️ Quick Start

CLI Usage

npx -y mcp-chinese-fortune

MCP Server Configuration

{
    "mcpServers": {
        "mcp-chinese-fortune": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-chinese-fortune"
            ]
        }
    }
}

💭Murmurs

This project is for educational and research purposes only.
Feature requests and contributions are welcome.
For custom features or integration with internal platforms, please contact the project maintainer.

Business Inquiries: deeppathai@outlook.com