M
MCP Directory CURATED DIRECTORY
911 MCP servers indexed
中文
← Back to directory
B

Bazi MCP

Community
Accurate Bazi calculation MCP server, providing reliable data for AI agents.
How to install ↓ Compare GitHub source repository ↗
Category
Other #51 of 230
Stars
★ 436 Popular
Transport
stdio (local process) · Streamable HTTP
Runtime
Node.js 22+
Credentials
No credential needed
License
ISC
Last commit
⚠
Tools
3
63FMRS · C

Bazi MCP is an open-source MCP server focused on Bazi calculation, providing accurate Bazi tools suitable for developers and metaphysics enthusiasts to integrate into AI applications.

Strongest · Documentation 16/20 Weakest · Reliability 8/20

Reliability
8/20
Security and permissions
12/20
Maintenance
14/20
Documentation
16/20
Setup experience
13/20
Why each score
Reliability 8/20
Static review shows the server wraps a reliable Bazi calculation library and tool definitions match README examples, but no tests or CI workflows were found, so actual behavior is unverified, capping reliability at 12.
Security and permissions 12/20
No external network calls, all calculation is local, no credential handling. Inputs handled by MCP framework, but no explicit input validation or rate limiting seen, potential DoS, but no red-line issues.
Maintenance 14/20
ISC license present, recent commits and releases, but no visible dependency update policy or security response channel, moderate score.
Documentation 16/20
README provides detailed tool parameters and examples, bilingual support, but lacks troubleshooting and limitations, so not full marks.
Setup experience 13/20
Simple install via npx and Smithery, supports stdio and HTTP, but lacks client config file examples (e.g., Claude Desktop) and runtime version compatibility notes, so slightly lower.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

Best for

  • AI application developers who need accurate Bazi calculation data
  • Chinese metaphysics enthusiasts or researchers who want to use AI tools for Bazi analysis
  • Users who wish to integrate Bazi and calendar features into AI assistants like Claude Desktop

Not for

  • Users who do not require high accuracy in Bazi calculations or only need simple entertainment
  • Non-technical users, as there is no GUI and command-line operations are required
  • Users who need commercial support or official guarantees (this is an open-source community-driven project)

Required permissions

  • Requires Node.js runtime environment
  • Requires network connectivity (for npx installation or communication with AI clients)
  • No additional system permissions needed, but ensure the AI client can access the local process or connect via HTTP

Risks and side effects

  • Bazi calculations are based on traditional metaphysics; results are for reference only and should not be used as a basis for decisions
  • Data may have inaccuracies despite the project's goal to improve precision
  • Open-source projects may update frequently or have unstable maintenance; monitor version changes
  • Content related to fortune-telling may be controversial; approach with rationality

Setup

Before you start

Runtime：Node.js 22+

Prerequisite: Node.js 22 or above. To start via Streamable HTTP, run npm start. To start via Stdio, configure your AI application (e.g., Claude Desktop) with the mcpServers JSON example: {"mcpServers":{"Bazi":{"command":"npx","args":["bazi-mcp"]}}}. You can also install automatically via Smithery: npx -y @smithery/cli install @cantian-ai/bazi-mcp --client claude. For detailed steps, refer to the project README.

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

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json
{
  "servers": {
    "Bazi": {
      "command": "npx",
      "args": [
        "bazi-mcp"
      ]
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add Bazi -- npx bazi-mcp

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

After configuring npx bazi-mcp in your client and restarting, the tools getBaziDetail, getSolarTimes, and getChineseCalendar should appear in the client's tool list. Calling getBaziDetail with 2000-05-15T12:00:00+08:00 should return a four-pillar chart, confirming the connection works.

Troubleshooting

  1. Ensure Node.js version is 22 or above, otherwise it may not run.
  2. When installing with npx, if network issues occur, check connectivity or use a proxy.
  3. If the Stdio method does not work in Claude Desktop, verify the configuration path and command.
  4. If getBaziDetail returns unexpected results, check the input date format (e.g., ISO format).
  5. Check the GitHub repository issues or community discussions for more help.

Things to try

Once connected, you can ask your AI assistant things like:

  • Calculate the full Bazi chart for 2000-05-15T12:00:00+08:00, including Ten Gods, Shen Sha, and Da Yun cycles.
  • Compute the Bazi pillars for lunar datetime 2000-05-15 12:00:00 for a female (gender 0).
  • Given the Bazi pillars 戊寅 己未 己卯 辛未, list all possible solar calendar datetimes.
  • Show me the Chinese almanac (Huangli) information for 2025-05-07, including suitable activities and clash directions.

Tools 3

getBaziDetail read-only
Calculate Bazi results based on the solar/lunar datetime, including four pillars, ten gods, and auspicious stars.
getSolarTimes read-only
Return a list of possible solar calendar datetimes based on the given Bazi.
getChineseCalendar read-only
Get Chinese calendar information for the specified solar calendar date (default is today).

Use cases

Provide Bazi calculation capability to AI agents for personality analysis and destiny forecasting.
Reverse-engineer possible birth times from a given Bazi to assist metaphysical research.
Get daily Chinese calendar information for selecting auspicious dates or travel reference.

Supported clients

Claude Desktop

Listed from the project's documentation, not tested by this site.

Overview

The Bazi MCP is the first AI-powered Bazi calculator server from Cantian AI, built to address inaccuracies in existing AI fortune-telling tools like GPT and DeepSeek. It delivers precise Bazi data for personality analysis, destiny forecasting, and more. It offers multiple tools, including calculating detailed Bazi results, reversing the Bazi to find possible solar datetimes, and getting Chinese calendar information. Originating from the popular _Chinese Bazi Fortune Teller_ GPTs in the GPT Store, this project is now integrated with Cantian AI (cantian.ai). We invite Bazi practitioners and AI enthusiasts to collaborate and contribute to our open-source community.

Similar servers

BioMCP 75 · B

One binary. One grammar. Evidence from the biomedical sources you already trust.

★ 659 · Tools 11 Compare with this →
Compare with other MCP servers

Source revision 61b9012759fb Data synced 2026-10-19 Read the FMRS scoring method