mingyu

From public sources

An 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。

MCP serverCategory: MCP Servers · AI & memory · Productivity · Search & knowledgeOpen sourcedata checked Oct 15, 2026

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.

Compatibility

Unknown means no evidence was found — not that the product is incompatible.
PlatformStatusArchitectureEvidenceConfidence
Claude (web & desktop)Unknown———
Claude CodeUnknown———
CursorUnknown———
VS CodeUnknown———
WindsurfUnknown———
ChatGPTUnknown———
AndroidCompatible—official build in release android-v1.3.1: mingyu-1.3.1.apk0.60

Releases

checked Oct 29, 2026
v1.3.1LatestOct 7, 2026Official source ↗

Files in 1.3.1

The marketplace does not host these files: downloads go to the official source. Files have not been scanned by us.
FilePlatformSizeSHA-256Download from the official source
mingyu-1.3.1.apkandroid · apk15.9 MB3ac8b2c11f77…Official source ↗
mingyu-1.3.1.apk.sha256checksums83 B49f76147485f…Official source ↗

Release history

Quality profile

algorithm quality-v1.0 · assessed Oct 15, 2026
Quality Score96
Risk Score0
Confidence 1.00
Quality Score and Risk Score are different measures. A high score does not guarantee safety.

Score components

Maintenance · 2020
last activity 6 days ago
Documentation · 1515
README 5069 chars, description present
Ready to use · 1515
install instructions: yes; releases: yes
Metadata · 1010
4/4 of description, homepage, license, topics
Releases · 1010
10 release(s), latest 8 days ago
Category confidence · 1010
classifier confidence 0.97
Adoption · 107
492 stars (log-dampened, 10k = max)
License clarity · 55
SPDX AGPL-3.0
Community · 55
issues enabled, 127 forks

License

AGPL-3.0
Known licensefrom the repository host

This is the catalog policy status, not legal advice.

Sources

github.com/Brhiza/mingyuPrimary★ 492 starslast activity Oct 9, 2026Primary repository · Confidence 1.00

Reviews

Sign in to write a review

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-mcp stdio;默认 full,请求在本机处理,不占用 Cloudflare Pages Functions 配额。
  • 在线 Remote MCP(本地进程不可用或需要远程免安装时):
    • 在支持 Remote MCP 的客户端添加 Streamable HTTP 类型的 Server URL:https://aov.cc/mcp
  • 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 首选;开箱即用):
    npx -y mingyu-mcp
    
    本地 CLI 默认采用 full 预设,返回完整结构化结果并默认计算当前年度星盘行运;请求在本地处理,不走 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 消息单独发送一次 HTTP POST,不接受 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 协议开源。

Open the repository ↗