MCP Directory

How to add Bazi MCP (八字 MCP) to Claude Desktop

AI-powered Bazi (Chinese Four Pillars) calculator for accurate destiny and personality data. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 393★ · stdio · no auth

Claude Desktop config for Bazi MCP (八字 MCP)

npx -y @smithery/cli install @cantian-ai/bazi-mcp --client claude
{
  "mcpServers": {
    "bazi-mcp-mcp": {
      "command": "npx",
      "args": [
        "bazi-mcp"
      ]
    }
  }
}

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the Bazi MCP (八字 MCP) config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm Bazi MCP (八字 MCP)'s tools appear under the 🔌 tools menu.

Before you start

  • Node.js 22 or above

What Bazi MCP (八字 MCP) can do in Claude Desktop

getBaziDetail

Calculate full Bazi (Four Pillars) results from a solar or lunar datetime. Args: solarDatetime (ISO, e.g. 2000-05-15T12:00:00+08:00), lunarDatetime (e.g. 2000-05-15 12:00:00), gender (0=female, 1=male; default 1), eightCharProviderSect (1 or 2; controls whether the 23:00-23:59 day stem belongs to tomorrow or today; default 2). Returns pillars with stems/branches, five elements, ten gods, hidden stems, na yin, void (空亡), fortune-luck cycles (大运), shensha (神煞), and clash/combine relations.

getSolarTimes

Return a list of possible solar-calendar datetimes that correspond to a given Bazi. Arg: bazi (String, the four pillars separated by spaces).

getChineseCalendar

Get Chinese almanac (黄历) information for a specified solar date (defaults to today). Arg: solarDatetime (ISO format, e.g. 2000-05-15T12:00:00+08:00). Returns lunar date, ganzhi, zodiac, na yin, solar term, 28 mansions, lucky directions, clash/sha, and auspicious/inauspicious activities (宜/忌).

Bazi MCP (八字 MCP) + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Bazi MCP (八字 MCP) config there under the "mcpServers" key and restart the client.

What transports does the server support?

Both Streamable HTTP (started with `npm start`) and stdio. For stdio, configure your AI app to launch it via `npx bazi-mcp`.

Does it require an API key?

No. The documented stdio configuration runs the server locally via npx with no authentication or environment variables.

Can I install it automatically?

Yes. It can be installed for Claude Desktop via Smithery: `npx -y @smithery/cli install @cantian-ai/bazi-mcp --client claude`.

View repo Full Bazi MCP (八字 MCP) page