Bazi

Provides a one-command MCP server to compute Bazi birth chart details including Four Pillars, Five Elements, zodiac, Chinese lunar date, and more.

typescript

8

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mymcp-fun-bazi": {
      "command": "npx",
      "args": [
        "-y",
        "@mymcp-fun/bazi"
      ]
    }
  }
}

You can run this MCP server to calculate Chinese birth charts (Bazi) and receive a detailed analysis, including Four Pillars, Five Elements, zodiac, and lunar date—all accessible from MCP-compliant clients with a single start. This setup lets you integrate the service into GUI clients or IDE extensions that support MCP servers for quick, accurate Bazi insights.

How to use

Install and run the MCP server using your preferred MCP client. This server is designed to work with Claude Desktop, Zed Editor, VS Code through MCP, or any compatible MCP client. After you configure the MCP client to connect to the server, you can ask it to compute a person’s Bazi details by providing their birth date, time, and optional timezone.

How to install

Prerequisites: you need Node.js 18+ and npm installed on your system. Use the following steps to start the server quickly.

# Direct start with MCP-compatible command
npx @mymcp-fun/bazi

# Alternative: install globally and run directly
npm install -g @mymcp-fun/bazi
bazi

Configuration and usage notes

MCP clients can load server configurations to connect automatically. A sample configuration for Claude Desktop is shown below. This enables the MCP client to start the server by invoking the package via npx with the appropriate arguments.

{
  "mcpServers": {
    "bazi": {
      "command": "npx",
      "args": ["-y", "@mymcp-fun/bazi"]
    }
  }
}

Examples of usage

From an MCP-enabled client, request Bazi details by providing the birth date and time. The server will return the Four Pillars, Five Elements distribution, zodiac, and lunar calendar information for the given birth moment.

Development and testing notes

If you are developing or testing locally, you can run the development server, build the project, and run tests as described in the development workflow. The project includes TypeScript sources, a dedicated MCP server entry point, and a suite of tests to ensure accuracy and MCP compatibility.

Available tools

get_bazi_details

Calculates birth chart details including Four Pillars, Five Elements distribution, zodiac, and lunar date from a given birth date and time.