cantian-ai/bazi-mcp
Bazi, also known as the Four Pillars of Destiny, is a traditional Chinese astrological system that uses a person's birth date and time to construct a chart of heavenly stems and earthly branches. This chart forms the basis for personality analysis, life path prediction, and compatibility assessment. The bazi-mcp server bridges this ancient practice with modern AI by providing a standardized interface for AI assistants to compute and interpret Bazi charts. It implements the Model Context Protocol (MCP), allowing seamless integration with MCP-compatible clients like Claude Desktop or any LLM-powered application. Built as a Node.js server using TypeScript, bazi-mcp accepts birth date, time, and optional location parameters and returns detailed Bazi charts including the eight characters, animal signs, element distribution, and other derived information. The server leverages the tymext library for accurate Chinese calendar calculations and supports both Gregorian and lunar dates. It provides multiple MCP tools for different levels of analysis, from basic chart generation to detailed elemental balance assessments, and supports stdio and streamable HTTP transports for flexible deployment via npx or Docker. Key features include comprehensive chart breakdowns, easy extensibility for custom analysis tools, and an open-source design that encourages community contributions. The server handles the computational heavy lifting of Bazi, while the interpretive part relies on the AI model's capabilities, making it a versatile backend for astrology-focused chatbots, personal assistants, or research tools. Its containerized deployment and detailed documentation lower the barrier for developers to incorporate traditional Chinese metaphysics into their software solutions.
- Category
- Developer Tools
- Pricing
- Open Source
Problem solved
Bazi analysis traditionally requires deep expertise or manual consultation with almanacs, making it inaccessible for casual users and hard to integrate into digital products. The bazi-mcp server solves this by providing a reliable, programmatic way to generate accurate Bazi charts and expose them to AI models, enabling automated, conversational astrology experiences without needing to implement complex Chinese calendar algorithms from scratch.
Use cases
- Developers building AI chatbots that offer personalized Bazi-based fortunes and advice.
- Hobbyists creating a personal astrology assistant that runs locally with Claude Desktop.
- Educational platforms teaching traditional Chinese metaphysics with interactive chart generation.
- Integrating Bazi analysis into dating apps for compatibility matching.
- Research projects studying correlations between Bazi patterns and real-world outcomes.
Audience
- Developers
- Hobbyists
Pros
- Free and open-source
- Seamless integration with AI via MCP
- Accurate Bazi calculations using tymext
- Flexible deployment options (Docker, npx)
- Extensible tool design for custom analysis
Cons
- Requires technical setup and MCP client
- Limited to Bazi; no other astrology systems
- Interpretation depth depends on the AI model
Official website: https://github.com/cantian-ai/bazi-mcp
Canonical LambdaBase page: https://www.lambdabase.com/tools/cantian-ai-bazi-mcp