Brhiza/mingyu

What it solves

Mingyu provides a standardized way to generate high-precision astrological and divination charts (排盘) and converts them into structured prompts that can be fed into any Large Language Model (LLM) for interpretation. It bridges the gap between traditional metaphysical calculations and AI-driven analysis.

How it works

The project consists of a core algorithm package (mingyu-core) that handles the complex calculations for various divination methods. It offers multiple integration paths: a REST API, an MCP (Model Context Protocol) server for AI clients like Claude Desktop and Cursor, and an Android app that allows users to trigger AI apps directly with the generated data.

Who it’s for

• Developers wanting to integrate traditional divination logic into their own apps via npm or API.
• AI Power Users who want to use LLMs to interpret astrological charts without manually calculating the data.
• Enthusiasts of traditional Chinese and Western metaphysics.

Highlights

• Broad Support: Covers Bazi, Zi Wei Dou Shu, Western Astrology, I Ching (Liuyao, Meihua), Qi Men Dun Jia, Tarot, and more.
• AI-Ready: Generates complete prompts specifically designed for LLM interpretation.
• Developer Tooling: Includes an npm package, OpenAPI specification, and MCP server support.
• Mobile Integration: Android app supports one-click handoff to AI applications like ChatGPT or Claude.