bazi-mcp
Author: cantian-ai
Description: MCP server that provides accurate Chinese Bazi (八字) calculations and related calendar utilities.
Stars: 126
Forks: 39
License: ISC License
Category: Specialized
Overview
Installation
Prerequisites:
1. Node.js ≥ 18
2. npm ≥ 9 (or Yarn / pnpm)
Steps:1. Clone the repository
git clone https://github.com/cantian-ai/bazi-mcp.git
cd bazi-mcp2. Install dependencies
npm install # or: yarn install / pnpm install3. Build the TypeScript sources
npm run build # usually compiles to ./dist4. Start the service (development)
npm run dev # nodemon / ts-node
# or production
npm start # executes compiled JS from ./dist5. Configuration
• Create a .env file or export environment variables before running:
PORT=3000 # HTTP port
LOG_LEVEL=info # logging verbosity
# (add any keys/tokens the project README describes, e.g. OPENAI_API_KEY)6. Optional Docker
docker build -t bazi-mcp .
docker run -p 3000:3000 --env-file .env bazi-mcp01
getBaziDetail
Calculate Bazi information based on the provided solar or lunar datetime.
02
getSolarTimes
Return a list of possible solar calendar datetimes that match the given Bazi.
03
getChineseCalendar
Retrieve Chinese calendar (Huangli) information for a specified solar datetime (defaults to today).
04
buildBaziFromLunarDatetime
Calculate the Bazi results from a lunar datetime. (deprecated)
05
buildBaziFromSolarDatetime
Calculate the Bazi results from a solar datetime. (deprecated)
License: ISC License
Updated 7/30/2025