mcp-registry/bazi-mcp

    ==================
      
       /// MCP ///
      /// BAZ ///
        
    ==================
        
    [server:online]
    [protocol:ready]

bazi-mcp

by cantian-ai

MCP server that provides accurate Chinese Bazi (八字) calculations and related calendar utilities.

126
39
Specialized
GitHubNPM

01

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)

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-mcp
2. Install dependencies
npm install # or: yarn install / pnpm install
3. Build the TypeScript sources
npm run build # usually compiles to ./dist
4. Start the service (development)
npm run dev # nodemon / ts-node # or production npm start # executes compiled JS from ./dist
5. 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-mcp

Documentation

License: ISC License
Updated 7/30/2025