mingli-mcp

Overview

The mingli-mcp server is a specialized Model Context Protocol implementation for fortune telling systems. It supports Zi Wei Doushu (Purple Star Astrology) and Bazi (Four Pillars of Destiny) with comprehensive features including birth charts, fortune analysis, and palace examinations. The server uses a modular architecture that makes it easy to extend with additional fortune-telling systems. It offers multiple transport protocols (stdio, HTTP, WebSocket) and supports 6 languages including Chinese, English, Japanese, Korean, and Vietnamese.

Try asking AI

After installing, here are 7 things you can ask your AI assistant:

• get_ziwei_chart

  获取紫微斗数完整排盘信息

  Try:帮我排一个紫微斗数盘：1990年5月20日，午时，男性Try:获取2000年8月16日寅时出生女性的紫微斗数
• get_ziwei_fortune

  获取紫微斗数运势信息

  Try:查询2000年8月16日寅时出生的女性，今天的紫微运势Try:看看1995年7月初十亥时出生的人今年运势如何
• analyze_ziwei_palace

  分析紫微斗数特定宫位

  Try:分析上面这个人的命宫Try:帮我看看财帛宫的情况如何
• list_fortune_systems

  列出所有可用的命理系统

  Try:有哪些命理系统可以用Try:展示所有支持的占卜系统
• get_bazi_chart

  获取八字（四柱）排盘信息

  Try:帮我算八字：1985年3月15日，卯时，女性Try:获取1995年7月10日申时出生男性的八字排盘
• get_bazi_fortune

  获取八字运势信息

  Try:看看1988年10月1日未时出生男性今年的大运Try:查询1992年3月15日辰时女性今年运势
• analyze_bazi_element

  分析八字五行强弱

  Try:帮我看看这个人的五行：1990年5月20日，午时，男Try:分析1995年7月10日申时出生男性的五行缺失

Comparable tools

Installation

{
  "mcpServers": {
    "mingli": {
      "command": "uvx",
      "args": ["mingli-mcp"],
      "env": {
        "LOG_LEVEL": "INFO"
      }
    }
  }
}

git clone https://github.com/spyfree/mingli-mcp
cd mingli-mcp
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

{
  "mcpServers": {
    "mingli": {
      "command": "/path/to/venv/bin/python",
      "args": ["/path/to/mingli_mcp.py"]
    }
  }
}

FAQ

What fortune-telling systems are currently supported?

Currently supports Zi Wei Doushu (Purple Star Astrology) and Bazi (Four Pillars of Destiny). Western astrology is planned for future releases.

How accurate are the fortune calculations?

The server uses the iztro-py library which implements traditional calculation methods. Accuracy depends on correct birth date/time input and proper interpretation of results.

Can I use this with multiple AI assistants?

Yes, the server supports standard MCP protocol and can be integrated with any MCP-compatible client like Claude Code, Cursor IDE, or custom applications.

Compare mingli-mcp with