概要
What is Bazi MCP?
Bazi MCP is the first AI-powered Bazi (Chinese Eight Characters) calculator, built to address inaccuracies in existing AI fortune-telling tools like GPT and DeepSeek. It provides reliable Bazi data for personality analysis, destiny forecasting, and Chinese metaphysics applications.
How to use Bazi MCP?
Install Node.js 22 or above, then run npm start to launch via Streamable HTTP transport, or configure it in an AI application (e.g., Claude Desktop) using the JSON config with npx bazi-mcp. The server exposes three tools: getBaziDetail (calculate Bazi from solar/lunar datetime), getSolarTimes (find possible solar datetimes from a Bazi string), and getChineseCalendar (get Chinese calendar info for a solar date).
Key features of Bazi MCP
- Accurate Bazi calculations for Chinese metaphysics analysis
- AI agent integration with precise Bazi data
- Community-driven open source project
- Supports both solar and lunar datetime inputs
- Provides detailed pillar analysis with 十神 (Ten Gods), 神煞 (spirit helpers), and 大运 (great fortune)
Use cases of Bazi MCP
- Calculate a person's Bazi from their birth date and gender for personality analysis
- Convert between Bazi strings and possible solar calendar dates
- Look up Chinese calendar information including 黄历 (almanac) data for any solar date
- Enable AI agents to provide reliable Bazi insights without common calculation errors
FAQ from Bazi MCP
What runtime does Bazi MCP require?
Node.js version 22 or above is required.
What transports does Bazi MCP support?
It supports both Streamable HTTP transport (via npm start) and Stdio transport (for integration with AI applications like Claude Desktop). It can also be installed automatically via Smithery.
What Bazi data can I get from the server?
The server provides comprehensive Bazi results including the four pillars, 天干地支 (Heavenly Stems and Earthly Branches), 五行 (Five Elements), 十神 (Ten Gods), 藏干 (hidden stems), 纳音 (Nayin), 神煞 (spirit helpers), 大运 (great fortune cycles), and 刑冲合会 (punishment, harm, combination interactions).
How do I configure gender and time zone for calculations?
The getBaziDetail tool accepts an optional gender parameter (0 for female, 1 for male, default 1) and an optional eightCharProviderSect parameter for the 23:00–23:59 time slot configuration (1 for next day's stem, 2 for same day's stem, default 2).
Where can I get help or contribute?
Contact the team at [email protected] or visit Cantian AI's website at cantian.ai.
