Log inSubmit server
Bazi Reader MCP logo

Bazi Reader MCP

by shunshi-ai

Calculates Bazi charts and Chinese almanac data through MCP, with true solar time correction and support for major MCP clients.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Bazi Reader MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "shunshi-ai-bazi-reader-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "shunshi-bazi-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 2 tools correctly (28d ago).

Overview

The shunshi-ai/bazi-reader-mcp MCP server exposes Bazi charting and Huangli almanac calculations through MCP tools. It wraps the shunshi-bazi-core TypeScript library and runs locally over stdio via npx, requiring Node.js 20 or newer. Chart calculations accept birth date, time, gender, and location data, with true solar time correction enabled by default. Reach for it when an AI client such as Claude Desktop, Cursor, or Cline needs Four Pillars, related Bazi data, or daily Chinese almanac information.

Use cases

  • Calculate Four Pillars charts from birth details
  • Apply true solar time correction using a city or coordinates
  • Look up daily Chinese almanac recommendations and taboos
  • Expose Bazi calculations to Claude, Cursor, or Cline

Key features

  • Bazi and Four Pillars chart calculation
  • True solar time correction
  • Major luck periods and Five Elements data
  • Gregorian and lunar Huangli lookups
  • Local stdio MCP server
  • Chinese, English, Japanese, and Korean terminology support

Tools2

What Bazi Reader MCP lets your agent do. Expand a tool for its parameters.

Verified live~1.3k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

19/20 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · shunshi-bazi-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars11Stargazers on the source repository.
npm downloads88Package downloads in the last 30 days.
Last commit4mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed2Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Bazi Reader MCP works

What shunshi-ai/bazi-reader-mcp MCP server does

The shunshi-ai/bazi-reader-mcp MCP server provides an MCP interface to a TypeScript calculation engine for Bazi, also known as Four Pillars, 四柱推命, or 사주팔자. It calculates a chart from a person's birth date, birth time, gender, and place information. Results can include the Four Pillars, Ten Gods, major luck periods, Five Elements balance, and additional relationship and deity data supported by the underlying library.

It also provides Huangli, or traditional Chinese almanac, lookups. A request can use a Gregorian or lunar-calendar date, or omit the date to request today's data. Huangli results cover items such as recommended and unsuitable activities, Pengzu taboos, deities, construction-day classifications, lunar mansions, auspicious directions, and time-period guidance.

How it works

The MCP package is a thin server around the separately published shunshi-bazi-core package. MCP clients start the server as a local stdio process and invoke its tools using structured requests. The server exposes two tools:

  • getBaziChart calculates a complete Bazi chart and related information.
  • getHuangli returns almanac information for a specified day or for today.

For chart requests, true solar time correction is enabled by default when a city or longitude and latitude are provided. The implementation also uses sect=1 by default, which places the 23:00 hour in the following day's pillar according to the project's documented convention. The calculation library is written in TypeScript and can also be used independently in Node.js or browser applications, but that direct library use is separate from the MCP server.

Setup and configuration

Install and run the MCP server with Node.js 20 or newer using:

Terminal
npx -y shunshi-bazi-mcp

Add that command to an MCP client's server configuration. For Claude Desktop, Cursor, and Cline, the configuration uses npx as the command and -y shunshi-bazi-mcp as its arguments. Restart the client after saving the configuration, then send a natural-language request for a chart or almanac lookup.

The shunshi-ai/bazi-reader-mcp MCP server does not document API keys, tokens, external service credentials, or required environment variables. Its documented quick-start path runs the published npm package locally.

Tools and capabilities

The chart tool includes true solar time correction, major luck periods, and relationship information such as combinations, clashes, punishments, harms, breaks, and controls where applicable.

The almanac tool accepts either solar or lunar dates. Its documented output includes daily recommendations and taboos, auspicious directions, and guidance for the twelve traditional time periods. The project describes terminology and usage for Chinese, English, Japanese, and Korean audiences, including the terms 四柱推命 and 사주팔자.

Limitations and notes

The documented server transport is local stdio; no hosted endpoint is provided. The project does not describe a natural-language interpretation or consultation tool beyond returning calculated chart and almanac data. Chart results depend on the supplied birth details and location, and the project's stated day-pillar behavior follows its sect=1 default. The repository is MIT licensed, while the separate Shunshi.AI product is described independently from this open-source package.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Bazi Reader MCP

Run `npx -y shunshi-bazi-mcp` with Node.js 20 or newer, then add the same command and arguments to your MCP client configuration.

Yes. The README provides a Claude Desktop stdio configuration and also lists Cursor and Cline as supported MCP clients.

It provides `getBaziChart` for Bazi chart calculations and `getHuangli` for Chinese almanac information.

No API key or external credential is documented for the local npm-based setup.

Yes. True solar time correction is enabled by default when a city or longitude and latitude are supplied.

Related MCP servers

All in Art & Culture All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewBazi Reader MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/shunshi-ai-bazi-reader-mcp?style=directory)](https://allmcps.com/mcp/shunshi-ai-bazi-reader-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/shunshi-ai-bazi-reader-mcp"><img src="https://allmcps.com/api/badge/shunshi-ai-bazi-reader-mcp?style=directory" alt="Bazi Reader MCP on AllMCPs" /></a>