Bazi MCP (八字 MCP) by Cantian AI logo

Bazi MCP (八字 MCP) by Cantian AI

Organization
cantian-ai

MCP server for Bazi (八字) information

Publishercantian-ai
Repositorybazi-mcp
LanguageTypeScript
Forks
156
Stars
380
Available tools
5
Transport typestdio
Categories
Other
LicenseISC
Links
GitHubHomepage
  • Connect tools to AI workflows

    Bazi MCP (八字 MCP) by Cantian AI exposes MCP capabilities that can be used by compatible AI clients and agents.

  • 5 available tools

    Browse the callable actions below, including names and descriptions when provided by the server.

  • Ready-to-copy setup

    Use the installation snippets to configure this server in your preferred MCP client.

  • Open source signals

    380 stars and 156 forks from the linked repository.

Bazi MCP (八字 MCP) by Cantian AI

smithery badge Verified on MseeP

Unlock precise Bazi insights with the Bazi MCP, the first AI-powered Bazi calculator. Built to address inaccuracies in existing AI fortune-telling tools like GPT and DeepSeek, our MCP delivers reliable Bazi data for personality analysis, destiny forecasting, and more.

Why Bazi MCP?

  • Accurate Bazi Calculations: Provide insightful Bazi information.
  • AI Agent Integration: Empowers AI agents with precise Bazi data.
  • Community-Driven: Join enthusiasts to advance Chinese metaphysics.

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, share insights, and contribute to our open-source community.

Get Involved

中文

八字 MCP是参天 AI 推出的首个面向玄学领域的 MCP，针对 GPT 和 DeepSeek 等算命工具常出现的排盘错误，提供精准的八字数据，助力性格分析、命运预测等应用。

八字 MCP 亮点

  • 精准排盘：提供全面的八字排盘信息。
  • AI 赋能：为 AI 智能体提供可靠八字服务。
  • 社区共建：欢迎命理爱好者参与交流与开发。

项目源于 GPT Store 热门应用Chinese Bazi Fortune Teller，现已融入参天 AI平台 (cantian.ai)。我们诚邀命理研究者与 AI 开发者加入，共同推动中国传统文化的传承与创新。

联系我们

前置需求 ｜ Prerequisite

Node.js 22 版本或以上。

Node.js 22 or above.

开始使用 ｜ Start

使用 Streamable HTTP 启动 | Start by Streamable HTTP transport

shell
npm start

使用 Stdio 启动 ｜ Start by Stdio transport

配置 AI 应用（例如 Claude Descktop）。

Configure AI application (e.g. Claude Desktop).

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

Installing via Smithery

To install bazi-mcp for Claude Desktop automatically via Smithery:

bash
npx -y @smithery/cli install @cantian-ai/bazi-mcp --client claude

工具列表 | Tools

getBaziDetail

根据给定的公历或农历时间计算八字信息。 Calculate the Bazi results based on the solar/lunar datetime.

参数 | Arguments

  • solarDatetime: String

    ISO 格式的阳历时间。例如：2000-05-15T12:00:00+08:00。
    Solar datetime in ISO format. Example: 2000-05-15T12:00:00+08:00.

  • lunarDatetime: String

    农历时间。例如：2000-05-15 12:00:00。
    Lunar datetime. Example: 2000-05-15 12:00:00.

  • gender: Number

    性别。可选。0 - 女，1-男。默认 1。
    Gender. Optional. 0 for female, 1 for male. 1 by default.

  • eightCharProviderSect： Number

    早晚子时配置。可选。1 - 表示 23:00-23:59 日干支为明天，2 - 表示 23:00-23:59 日干支为当天。默认 2。 Configuration for eight char provider. Optional. 1 for meaning the day stem of 23:00-23:59 is for tomorrow, 2 for meaning the day stem of 23:00-23:59 is for today. 2 by default.

结果示例 ｜ Result example

json
{
  "性别": "男",
  "阳历": "1998年7月31日 14:10:00",
  "农历": "农历戊寅年六月初九辛未时",
  "八字": "戊寅 己未 己卯 辛未",
  "生肖": "虎",
  "日主": "己",
  "年柱": {
    "天干": {
      "天干": "戊",
      "五行": "土",
      "阴阳": "阳",
      "十神": "劫财"
    },
    "地支": {
      "地支": "寅",
      "五行": "木",
      "阴阳": "阳",
      "藏干": {
        "主气": {
          "天干": "甲",
          "十神": "正官"
        },
        "中气": {
          "天干": "丙",
          "十神": "正印"
        },
        "余气": {
          "天干": "戊",
          "十神": "劫财"
        }
      }
    },
    "纳音": "城头土",
    "旬": "甲戌",
    "空亡": "申酉",
    "星运": "死",
    "自坐": "长生"
  },
  "月柱": {
    "天干": {
      "天干": "己",
      "五行": "土",
      "阴阳": "阴",
      "十神": "比肩"
    },
    "地支": {
      "地支": "未",
      "五行": "土",
      "阴阳": "阴",
      "藏干": {
        "主气": {
          "天干": "己",
          "十神": "比肩"
        },
        "中气": {
          "天干": "丁",
          "十神": "偏印"
        },
        "余气": {
          "天干": "乙",
          "十神": "七杀"
        }
      }
    },
    "纳音": "天上火",
    "旬": "甲寅",
    "空亡": "子丑",
    "星运": "冠带",
    "自坐": "冠带"
  },
  "日柱": {
    "天干": {
      "天干": "己",
      "五行": "土",
      "阴阳": "阴"
    },
    "地支": {
      "地支": "卯",
      "五行": "木",
      "阴阳": "阴",
      "藏干": {
        "主气": {
          "天干": "乙",
          "十神": "七杀"
        }
      }
    },
    "纳音": "城头土",
    "旬": "甲戌",
    "空亡": "申酉",
    "星运": "病",
    "自坐": "病"
  },
  "时柱": {
    "天干": {
      "天干": "辛",
      "五行": "金",
      "阴阳": "阴",
      "十神": "食神"
    },
    "地支": {
      "地支": "未",
      "五行": "土",
      "阴阳": "阴",
      "藏干": {
        "主气": {
          "天干": "己",
          "十神": "比肩"
        },
        "中气": {
          "天干": "丁",
          "十神": "偏印"
        },
        "余气": {
          "天干": "乙",
          "十神": "七杀"
        }
      }
    },
    "纳音": "路旁土",
    "旬": "甲子",
    "空亡": "戌亥",
    "星运": "冠带",
    "自坐": "衰"
  },
  "胎元": "庚戌",
  "胎息": "甲戌",
  "命宫": "乙卯",
  "身宫": "乙卯",
  "神煞": {
    "年柱": ["国印", "亡神"],
    "月柱": ["天德合", "月德合", "天乙贵人", "太极贵人", "福星贵人", "金舆", "血刃", "华盖", "天喜", "元辰"],
    "日柱": ["天德合", "月德合", "桃花", "九丑", "童子煞"],
    "时柱": ["天乙贵人", "太极贵人", "福星贵人", "金舆", "血刃", "华盖", "天喜", "元辰", "童子煞"]
  },
  "大运": {
    "起运年龄": 4,
    "起运日期": "2001-1-26",
    "大运": [
      {
        "干支": "庚申",
        "开始年份": 2001,
        "结束": 2010,
        "天干十神": "伤官",
        "地支十神": ["伤官", "正财", "劫财"],
        "地支藏干": ["庚", "壬", "戊"],
        "开始年龄": 4,
        "结束年龄": 13
      },
      {
        "干支": "辛酉",
        "开始年份": 2011,
        "结束": 2020,
        "天干十神": "食神",
        "地支十神": ["食神"],
        "地支藏干": ["辛"],
        "开始年龄": 14,
        "结束年龄": 23
      },
      {
        "干支": "壬戌",
        "开始年份": 2021,
        "结束": 2030,
        "天干十神": "正财",
        "地支十神": ["劫财", "食神", "偏印"],
        "地支藏干": ["戊", "辛", "丁"],
        "开始年龄": 24,
        "结束年龄": 33
      },
      {
        "干支": "癸亥",
        "开始年份": 2031,
        "结束": 2040,
        "天干十神": "偏财",
        "地支十神": ["正财", "正官"],
        "地支藏干": ["壬", "甲"],
        "开始年龄": 34,
        "结束年龄": 43
      },
      {
        "干支": "甲子",
        "开始年份": 2041,
        "结束": 2050,
        "天干十神": "正官",
        "地支十神": ["偏财"],
        "地支藏干": ["癸"],
        "开始年龄": 44,
        "结束年龄": 53
      },
      {
        "干支": "乙丑",
        "开始年份": 2051,
        "结束": 2060,
        "天干十神": "七杀",
        "地支十神": ["比肩", "偏财", "食神"],
        "地支藏干": ["己", "癸", "辛"],
        "开始年龄": 54,
        "结束年龄": 63
      },
      {
        "干支": "丙寅",
        "开始年份": 2061,
        "结束": 2070,
        "天干十神": "正印",
        "地支十神": ["正官", "正印", "劫财"],
        "地支藏干": ["甲", "丙", "戊"],
        "开始年龄": 64,
        "结束年龄": 73
      },
      {
        "干支": "丁卯",
        "开始年份": 2071,
        "结束": 2080,
        "天干十神": "偏印",
        "地支十神": ["七杀"],
        "地支藏干": ["乙"],
        "开始年龄": 74,
        "结束年龄": 83
      },
      {
        "干支": "戊辰",
        "开始年份": 2081,
        "结束": 2090,
        "天干十神": "劫财",
        "地支十神": ["劫财", "七杀", "偏财"],
        "地支藏干": ["戊", "乙", "癸"],
        "开始年龄": 84,
        "结束年龄": 93
      },
      {
        "干支": "己巳",
        "开始年份": 2091,
        "结束": 2100,
        "天干十神": "比肩",
        "地支十神": ["正印", "伤官", "劫财"],
        "地支藏干": ["丙", "庚", "戊"],
        "开始年龄": 94,
        "结束年龄": 103
      }
    ]
  },
  "刑冲合会": {
    "年": {
      "天干": {},
      "地支": {}
    },
    "月": {
      "天干": {},
      "地支": {
        "半合": [
          {
            "柱": "日",
            "知识点": "未卯半合木",
            "元素": "木"
          }
        ]
      }
    },
    "日": {
      "天干": {},
      "地支": {
        "半合": [
          {
            "柱": "月",
            "知识点": "卯未半合木",
            "元素": "木"
          },
          {
            "柱": "时",
            "知识点": "卯未半合木",
            "元素": "木"
          }
        ]
      }
    },
    "时": {
      "天干": {},
      "地支": {
        "半合": [
          {
            "柱": "日",
            "知识点": "未卯半合木",
            "元素": "木"
          }
        ]
      }
    }
  }
}

getSolarTimes

根据给定的八字返回可能的公历时间列表。 Return a list of possible solar calendar datetime based on the given Bazi.

参数 | Arguments

  • bazi: String

    八字，各柱用空格隔开。 Bazi, with each pillar separated by a space.

结果示例 ｜ Result example

json
["1758-07-29 14:00:00", "1818-07-15 14:00:00", "1998-07-31 14:00:00"]

getChineseCalendar

获取指定公历时间（默认今天）的黄历信息。 Get chinese calendar information for the specified solar calendar date (default is today).

参数 | Arguments

  • solarDatetime

    ISO 格式的阳历时间。例如：2000-05-15T12:00:00+08:00。
    Solar datetime in ISO format. Example: 2000-05-15T12:00:00+08:00.

结果示例 ｜ Result example

json
{
  "公历": "2025年5月7日 星期三",
  "农历": "农历乙巳年四月初十",
  "干支": "乙巳 辛巳 丙子",
  "生肖": "蛇",
  "纳音": "涧下水",
  "节气": "立夏",
  "二十八宿": "箕水豹吉",
  "彭祖百忌": "丙不修灶必见灾殃 子不问卜自惹祸殃",
  "喜神方位": "西南",
  "阳贵神方位": "西",
  "阴贵神方位": "西北",
  "福神方位": "东",
  "财神方位": "西南",
  "冲煞": "冲马(午)煞南",
  "宜": "嫁娶,祭祀,祈福,求嗣,开光,出行,拆卸,动土,上梁,出火,进人口,入宅,移徙,安床,栽种,纳畜,牧养,竖柱,安门,修造,解除,会亲友",
  "忌": ""
}

Keywords: Bazi MCP, Bazi AI Agent, Fengshui AI Agent, Bazi Calculator MCP, Bazi Calculator AI, Cantian AI

Installation

TypingMind
Prerequisites:

Node.js 18+

{
  "mcpServers": {
    "cantian-ai-bazi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bazi-mcp"
      ]
    }
  }
}

Use Bazi MCP (八字 MCP) by Cantian AI MCP with multiple AI models

TypingMind connects MCP tools at the workspace level, so once Bazi MCP (八字 MCP) by Cantian AI is connected, you can use it with different AI models in TypingMind instead of setting it up separately for each model. This MCP runs locally through the TypingMind MCP connector on your device.

Setup guide to use the local connector

Use this when the MCP server needs access to local files, apps, or private resources on your computer.

1

Open the MCP settings

In TypingMind, go to Settings, Advanced Settings, then Model Context Protocol and choose Setup Connector.

  1. Open TypingMind in your browser.
  2. Click the Settings icon.
  3. Go to Advanced Settings.
  4. Open the Model Context Protocol section.
  5. Click Setup Connector and choose This Device.
TypingMind MCP connector setup screen with This Device selected
2

Run the connector command

Choose This Device, copy the command from TypingMind, and run it in Terminal. Keep the process running while you use MCP.

  1. Copy the setup command shown by TypingMind.
  2. Open Terminal on macOS or Windows Terminal on Windows.
  3. Paste and run the command.
  4. Approve the package install if Terminal asks you to proceed.
  5. Keep the Terminal window running while using MCP tools.
3

Add Bazi MCP (八字 MCP) by Cantian AI as a server

When the connector status is Ready, click Edit Servers and paste the MCP server configuration.

  1. Wait until the connector status shows Ready.
  2. Click Edit Servers.
  3. Paste the Bazi MCP (八字 MCP) by Cantian AI MCP server configuration.
  4. Save the server list.
  5. Refresh if you want to confirm the connector is still ready.
TypingMind MCP settings showing active server and Edit Servers button
{
  "mcpServers": {
    "cantian-ai-bazi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bazi-mcp"
      ]
    }
  }
}
4

Use it across models

Save the server list, open Plugins, enable the Bazi MCP (八字 MCP) by Cantian AI MCP tools, then select any supported AI model in TypingMind and use the tools in chat or assign them to an AI agent.

  1. Open the Plugins page in TypingMind.
  2. Enable the Bazi MCP (八字 MCP) by Cantian AI MCP tools.
  3. Start a chat and choose the AI model you want to use.
  4. Use the MCP tools in chat or assign them to an AI agent.
  5. Switch to another AI model whenever needed without reconnecting MCP.
TypingMind chat using enabled MCP tools with a selected AI model
Can you use Bazi MCP (八字 MCP) by Cantian AI to help me with this task?
Bazi MCP (八字 MCP) by Cantian AI
Sure. I read it.
Here is what I found using Bazi MCP (八字 MCP) by Cantian AI.

Frequently asked questions

What is the Bazi MCP (八字 MCP) by Cantian AI MCP server used for?

Bazi MCP (八字 MCP) by Cantian AI is an MCP server that lets compatible AI clients connect to external tools and context. In TypingMind, you can add this MCP server once and make its tools available in your AI workspace.

Can I use Bazi MCP (八字 MCP) by Cantian AI MCP with multiple AI models in TypingMind?

Yes. TypingMind connects MCP tools at the workspace level, so you can use Bazi MCP (八字 MCP) by Cantian AI with different AI models such as Claude, ChatGPT, Gemini, or other models you have configured in TypingMind without setting up the MCP server separately for each model.

Why use Bazi MCP (八字 MCP) by Cantian AI MCP with TypingMind?

TypingMind is one of the best frontends for LLM chat because it brings multiple AI models, prompts, plugins, AI agents, API keys, and MCP tools into one workspace. With Bazi MCP (八字 MCP) by Cantian AI connected, you can use its MCP tools across your preferred models while keeping your chat workflow organized in TypingMind.

How do I connect Bazi MCP (八字 MCP) by Cantian AI MCP to TypingMind?

Bazi MCP (八字 MCP) by Cantian AI runs through the TypingMind local MCP connector. This is best when the MCP server needs access to local files, desktop apps, command-line tools, or private resources on your computer.

What tools does Bazi MCP (八字 MCP) by Cantian AI MCP provide in TypingMind?

Bazi MCP (八字 MCP) by Cantian AI exposes 5 MCP tools that can be enabled from the TypingMind Plugins page and used in chat or assigned to AI agents.

Do I need to share my API keys with TypingMind to use Bazi MCP (八字 MCP) by Cantian AI MCP?

No. TypingMind is local-first and lets you keep your model providers, API keys, prompts, and MCP configuration under your control. If Bazi MCP (八字 MCP) by Cantian AI requires authentication, add the required headers, OAuth settings, or local configuration for that MCP server when you create the connection.

Related MCP Servers

View all
Coding-Solo logo

Godot MCP

Coding-Solo
CommunityPopular

MCP server for interfacing with Godot game engine. Provides tools for launching the editor, running projects, and capturing debug output.

363
3.6K
0 tools
View details
punitarani logo

Fli - 航班搜索 MCP 服务器与库

punitarani
CommunityPopular

Google Flights MCP, CLI and Python Library

293
2.6K
0 tools
View details
ahujasid logo

Ableton Live

ahujasid
CommunityPopular

Enables control of Ableton Live music production software through a bidirectional communication system that supports track creation, MIDI editing, playback control, instrument loading, and library browsing for music composition and sound design workflows.

327
2.5K
16 tools
View details
datadaddy89 logo

Looker MCP

datadaddy89
CommunityPopular

Query Looker data with natural language using Google's Conversational Analytics API. Supports stdio (Claude Desktop) and HTTP (Cloud Run) deployment modes.

0
2.4K
17 tools
View details

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇