mingyu
From public sourcesAn all-in-one divination toolkit covering BaZi, Zi Wei Dou Shu, astrological charts, Liu Yao, Mei Hua, Qi Men, Da Liu Ren, Xiao Liu Ren, tarot, Lenormand, lot oracles and date selection, outputting structured prompts and data. Provides a public API, an MCP Server and a skill.
Machine translation · Show original
八字、紫微、星盘、六爻、梅花、奇门、大六壬、小六壬、塔罗、雷诺曼、灵签、择日一站式玄学算命占卜工具包,输出结构化提示词与数据。提供公开 API、MCP Server 与 skill。
Overview
- ai
- bazi
- da-liuren
- divination
- fortune-telling
- lenormand
- lingqian
- liuyao
- mcp
- mcp-server
Installation
Commands are shown, never run by the marketplace. Check them against the official documentation.- Official websiteFrom public sourcesfrom catalog metadataaov.cc/ ↗
- Official release filesFrom public sourcesfrom the latest official releasegithub.com/Brhiza/mingyu/releases/tag/android-v1.3.1 ↗
- Build from sourceFrom public sourcesfrom catalog metadata
Build from source: no validated build recipe — follow the repository instructions.
github.com/Brhiza/mingyu ↗
Compatibility
Unknown means no evidence was found — not that the product is incompatible.| Platform | Status | Architecture | Evidence | Confidence |
|---|---|---|---|---|
| Claude (web & desktop) | Unknown | — | — | — |
| Claude Code | Unknown | — | — | — |
| Cursor | Unknown | — | — | — |
| VS Code | Unknown | — | — | — |
| Windsurf | Unknown | — | — | — |
| ChatGPT | Unknown | — | — | — |
| Android | Compatible | — | official build in release android-v1.3.1: mingyu-1.3.1.apk | 0.60 |
Releases
checked Oct 29, 2026Files in 1.3.1
| File | Platform | Size | SHA-256 | Download from the official source |
|---|---|---|---|---|
| mingyu-1.3.1.apk | android · apk | 15.9 MB | 3ac8b2c11f77… | Official source ↗ |
| mingyu-1.3.1.apk.sha256 | checksums | 83 B | 49f76147485f… | Official source ↗ |
Release history
- v1.3.0Sep 14, 2026Official source ↗
- v1.2.0Sep 11, 2026Official source ↗
- v1.1.5Sep 9, 2026Official source ↗
- v1.1.4Sep 9, 2026Official source ↗
- v1.1.3Sep 7, 2026Official source ↗
- v1.1.2Sep 3, 2026Official source ↗
- v1.1.1Sep 1, 2026Official source ↗
Quality profile
algorithm quality-v1.0 · assessed Oct 15, 2026Score components
License
AGPL-3.0This is the catalog policy status, not legal advice.
Sources
Reviews
No reviews yet.
Alternatives
README
From Brhiza/mingyu · license AGPL-3.0 · fetched Oct 29, 2026命语 (Mingyu)
命语是一套免费开源的在线算命、占卜排盘与 AI 解读提示词工具。输入出生时间或所问之事,即可完成高精度排盘,并生成可直接交给任意大模型解读的完整提示词。
⚡ 一键接入(Agent 技能 & 在线 MCP)
- Agent Skill(推荐 · 免配置一句话安装):
npx skills add Brhiza/mingyu --skill mingyu -g -y - Skill 安装不会自动注册 MCP 服务。需要连接 MCP 时,如果客户端能启动本地进程,优先单独配置
npx -y mingyu-mcpstdio;默认full,请求在本机处理,不占用 Cloudflare Pages Functions 配额。 - 在线 Remote MCP(本地进程不可用或需要远程免安装时):
- 在支持 Remote MCP 的客户端添加 Streamable HTTP 类型的 Server URL:
https://aov.cc/mcp
- 在支持 Remote MCP 的客户端添加 Streamable HTTP 类型的 Server URL:
- QQ 交流群:命语 Mingyu 技术交流群(1080947018)
📿 功德箱
命语与时月东方均为个人业余维护的免费开源项目。
为什么叫“功德箱”?
本项目收到的全部赞助款项目前均定期全额捐赠给社会正规慈善与公益事业(用于爱心助学、困境老人救助与乡村公益等)。感谢每一位支持者的善意!
🔮 支持功能
| 分类 | 术数方法 | 主要功能 |
|---|---|---|
| 命理运势 | 八字命理、紫微斗数、八字紫微合参、西方星盘、七政四余 | 支持真太阳时换算、大运流年流月流日细盘、三方四正、庙旺四化、神煞、合盘分析,以及七政行限与流曜 |
| 周易占卜 | 六爻纳甲、梅花易数 | 支持手摇/指定卦象、京房八宫纳甲、六亲六神、世应动变、体用生克与四时旺衰 |
| 三式绝学 | 奇门遁甲、大六壬、金口诀、太乙神数、皇极经世 | 支持时家转盘/飞盘奇门、月将天地盘四课三传、阴阳五用、年计七十二局与元会运世 |
| 牌卡灵签 | 西方塔罗牌、雷诺曼牌、三山国王灵签、小六壬 | 包含 78 张塔罗全牌阵、36 张雷诺曼及大 Tableau、揭西祖庙 92 签全篇签谱 |
| 择日风水 | 黄历择吉、八宅明镜、玄空飞星、五运六气 | 建除十二神与宜忌排查、东四西四命卦、三元九运飞星排盘、流年流月紫白加临与客主加临 |
🛠️ 开发者接入
1. 核心算法包 mingyu-core
npm install mingyu-core
import { generateBazi, generateLiuyao, drawTarotSpread } from 'mingyu-core';
// 八字排盘
const bazi = generateBazi({ solarDate: '1995-08-18', solarTime: '09:30', gender: '男' });
// 六爻起卦
const liuyao = generateLiuyao(new Date());
// 抽塔罗牌
const tarot = drawTarotSpread('celtic');
详见 mingyu-core 文档。
2. 公开 REST API
基础地址:https://aov.cc/api/v1
- API 接口文档 · OpenAPI 规范 · LLMs.txt
- 要把资料交给 AI 解读时,只调用一次对应的
/prompt;服务端会同时完成排盘并返回任务书。只有需要展示或继续计算结构化盘面时才调用/calculate。
3. MCP Server
- 本地 npx CLI(Agent/Skill 首选;开箱即用):
本地 CLI 默认采用npx -y mingyu-mcpfull预设,返回完整结构化结果并默认计算当前年度星盘行运;请求在本地处理,不走 Cloudflare Pages Functions。 - 在线 Remote MCP(本地进程不可用或需要远程免安装时):在 Cursor、Windsurf、Claude Desktop 等客户端中配置 Streamable HTTP 远程端点:
https://aov.cc/mcp(不要按旧版 SSE 类型配置)。在线提示词通常默认summary,非幂等的一次性起卦、抽牌、求签提示词默认full;显式responseMode优先。summary不缩小算法计算范围;星盘默认本命natal。在线范围限制见 API 文档。 - 需要 AI 解读时只调用一次
*_prompt;遇到RESOURCE_LIMIT先缩小或拆分参数,不要原样自动重试。在线 MCP 每条 JSON-RPC 消息单独发送一次 HTTPPOST,不接受 batch;单条请求体最多 512 KiB。每次请求计入 Cloudflare 请求用量,避免轮询和紧密重试。在线 REST 的范围保护见 API 文档。
(本地源码开发也可通过 pnpm mcp 启动,详见 MCP 服务文档)
4. Agent Skill
npx skills add Brhiza/mingyu --skill mingyu -g -y
📱 Android 原生应用
提供适配移动端的 Android 原生 APK,支持在生成排盘后一键唤起已安装的 AI 应用(如 ChatGPT、Claude、Kimi 等)直接对话,API Key 仅保存在本地设备。
正式 APK 发布后会同步到 download.aov.cc 并由 Cloudflare CDN 分发;应用默认使用官方下载,失败时回退到 GitHub Release。
# 同步 Web 资源到 Android 工程
pnpm android:sync
🚀 本地开发与构建
# 克隆仓库并安装依赖
git clone https://github.com/Brhiza/mingyu.git
cd mingyu
pnpm install
# 启动开发服务器
pnpm dev
# 运行测试
pnpm test
# 打包构建
pnpm build
⛩️ 关于三山国王灵签
三山国王是潮汕与客家地区重要的民间信仰,祖庙位于广东省揭西县河婆街道。作者整理并保留了祖庙传承的 92 签灵签体系,每签保留签号、签题、签诗原文与典故。
🌟 基于命语构建
时月东方
时月东方是一款基于命语核心能力构建的东方术数工具,使用 Vue 3 与 Vite 实现,也可以作为 mingyu-core 在独立产品中接入和使用的实际参考。
📚 文档目录
⚖️ 免责声明
本工具提供的排盘结果与 AI 解读提示词仅供传统文化研究与休闲娱乐参考,不构成且不可替代医疗、心理、法律、投资等专业建议。
📄 开源协议
本项目基于 AGPL-3.0-only 协议开源。