MCP Directory

How to add Bazi MCP (八字 MCP) to Cursor

AI-powered Bazi (Chinese Four Pillars) calculator for accurate destiny and personality data. Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor 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 Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the Bazi MCP (八字 MCP) config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of Bazi MCP (八字 MCP)'s tools to confirm it's connected.

Before you start

  • Node.js 22 or above

What Bazi MCP (八字 MCP) can do in Cursor

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) + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.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