bazi-mcp

bazi-mcp

AI-powered and MCP-compliant Bazi calculator for accurate Chinese metaphysics insights.

156
Stars
47
Forks
156
Watchers
1
Issues
Bazi MCP provides precise Bazi (Four Pillars) calculations, empowering AI agents with reliable Chinese fortune-telling and personality analysis data. Built to address inaccuracies in existing AI-based Bazi tools, it supports solar/lunar calendar conversions and advanced Chinese metaphysics analytics. Designed for integration with AI applications and agents, it offers detailed Bazi readings, Chinese calendar insights, and advanced features for personalized destiny forecasting.

Key Features

Accurate Bazi calculations based on solar or lunar datetime
Standardized MCP (Model Context Protocol) integration
Detailed four pillars (bazi) readings and analysis
Chinese calendar (Huangli) information retrieval
AI agent and application integration support
Configurable calculation options, including time segment specifics
Sample output and API documentation
Support for gender and advanced configuration
Community-driven collaboration and enhancements
Deprecated endpoints for legacy compatibility

Use Cases

Empowering AI chatbots/assistants with Chinese fortune-telling capabilities
Providing personalized Bazi-based personality assessments
Offering Chinese date and almanac information to users
Enhancing AI-driven destiny and life path forecasting services
Integrating precise Bazi calculations into third-party AI tools
Supporting research and analysis in Chinese metaphysics
Developing apps or agents for daily horoscope and calendar functions
Correcting common errors in AI-based Bazi platforms
Facilitating community engagement and collaborative metaphysics projects
Enabling automated astrology or Feng Shui consulting tools

README

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

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

buildBaziFromLunarDatetime (deprecated)

根据农历时间计算八字结果。
Calculate the BaZi results based on the lunar datetime.

参数 | Arguments

  • 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.

buildBaziFromSolarDatetime (deprecated)

根据阳历时间计算八字结果。
Calculate the BaZi results based on the solar 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.

  • gender: Number

    性别。可选。0 - 女,1-男。
    Gender. Optional. 0 for female, 1 for male.

  • 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.

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

Star History

Star History Chart

Repository Owner

cantian-ai
cantian-ai

Organization

Repository Details

Language TypeScript
Default Branch dev
Size 65 KB
Contributors 5
License ISC License
MCP Verified Sep 2, 2025

Programming Languages

TypeScript
95.93%
JavaScript
2.45%
Dockerfile
1.62%

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • mcp-server

    mcp-server

    A production-ready Model Context Protocol server for advanced aerospace and astrodynamics calculations.

    The mcp-server provides a Model Context Protocol (MCP) server specifically designed for aerospace and astrodynamics computations. It offers both STDIO and HTTP/SSE transport options, enabling seamless integration with MCP clients for tasks like celestial body ephemeris, orbital mechanics, geometry, ground station operations, and time system conversions. Powered by the IO Aerospace Astrodynamics framework, it supports rapid, context-aware scientific tool execution for applications in mission analysis and research. Extensible deployment methods, including Docker and .NET, and a focus on easy client integration are core components.

    • 1
    • MCP
    • IO-Aerospace-software-engineering/mcp-server
  • OpenMCP

    OpenMCP

    A standard and registry for converting web APIs into MCP servers.

    OpenMCP defines a standard for converting various web APIs into servers compatible with the Model Context Protocol (MCP), enabling efficient, token-aware communication with client LLMs. It also provides an open-source registry of compliant servers, allowing clients to access a wide array of external services. The platform supports integration with local and remote hosting environments and offers tools for configuring supported clients, such as Claude desktop and Cursor. Comprehensive guidance is offered for adapting different API formats including REST, gRPC, GraphQL, and more into MCP endpoints.

    • 252
    • MCP
    • wegotdocs/open-mcp
  • mcp

    mcp

    Universal remote MCP server connecting AI clients to productivity tools.

    WayStation MCP acts as a remote Model Context Protocol (MCP) server, enabling seamless integration between AI clients like Claude or Cursor and a wide range of productivity applications, such as Notion, Monday, Airtable, Jira, and more. It supports multiple secure connection transports and offers both general and user-specific preauthenticated endpoints. The platform emphasizes ease of integration, OAuth2-based authentication, and broad app compatibility. Users can manage their integrations through a user dashboard, simplifying complex workflow automations for AI-powered productivity.

    • 27
    • MCP
    • waystation-ai/mcp
  • mcpmcp-server

    mcpmcp-server

    Seamlessly discover, set up, and integrate MCP servers with AI clients.

    mcpmcp-server enables users to discover, configure, and connect MCP servers with preferred clients, optimizing AI integration into daily workflows. It supports streamlined setup via JSON configuration, ensuring compatibility with various platforms such as Claude Desktop on macOS. The project simplifies the connection process between AI clients and remote Model Context Protocol servers. Users are directed to an associated homepage for further platform-specific guidance.

    • 17
    • MCP
    • glenngillen/mcpmcp-server
  • pluggedin-mcp-proxy

    pluggedin-mcp-proxy

    Unified proxy server for Model Context Protocol data exchanges and AI integrations

    Aggregates multiple Model Context Protocol (MCP) servers into a single, unified proxy interface, supporting real-time discovery, management, and orchestration of AI model resources, tools, and prompts. Enables seamless interaction between MCP clients such as Claude, Cline, and Cursor, while integrating advanced document search, AI document exchange, and workspace management. Provides flexible transport modes (STDIO and Streamable HTTP), robust authentication, and comprehensive security measures for safe and scalable AI data exchange.

    • 87
    • MCP
    • VeriTeknik/pluggedin-mcp-proxy
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results