Bazi MCP (八字 MCP) by Cantian AI

Q: Where can I get help or contribute?

Contact the team at support@cantian.ai or visit Cantian AI's website at cantian.ai.

@cantian-ai

Repository

About Bazi MCP (八字 MCP) by Cantian AI

MCP server for Bazi (八字) information

#bazi #astrolgy #ai #bazi-calculator

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "Bazi": {
      "command": "npx",
      "args": [
        "bazi-mcp"
      ]
    }
  }
}

Tools

根据时间（公历或农历）、性别来获取八字信息。solarDatetime和lunarDatetime必须传且只传其中一个。

根据八字获取公历时间列表。返回的时间格式为：YYYY-MM-DD hh:mm:ss。例如时间1998年7月31日下午2点整表示为：1998-07-31 14:00:00

获取指定公历时间（默认今天）的黄历信息。

Overview

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.

Frequently asked questions

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?

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.

Comments

Basic information

More Other MCP servers

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep