MCP Directory

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

AI-powered Bazi (Chinese Four Pillars) calculator for accurate destiny and personality data. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

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

Windsurf 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 Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Bazi MCP (八字 MCP) config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Bazi MCP (八字 MCP)'s tools become available to Cascade.

Before you start

  • Node.js 22 or above

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

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

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_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