Brhiza/mingyu：八字、紫微、星盘、六爻、梅花、奇门、大六壬、小六壬、塔罗、雷

Brhiza

552

143 6

GNU Affero General Public License v3.0

技术解读

以下内容由 GitRead 中文社区编辑团队基于项目 README 与官方资料整理，结合中文开发者的常见使用场景补充技术选型建议。具体以项目官方文档为准。

Brhiza/mingyu 项目技术分析

项目背景与痛点

八字、紫微、星盘、六爻、梅花、奇门、大六壬、小六壬、塔罗、雷诺曼、灵签、择日，这些算命占卜工具深深植根于东方文化中，开发者们通过将这些传统工具转化为结构化数据和可读性强的提示词，为现代用户提供了便利。然而，市面上大多数此类工具多属散落分布、技术实现不透明，缺乏统一的系统规范和技术支持，这对需要通过 API 或协议访问这些服务的开发者构成了实际痛点。

Brhiza/mingyu 应运而生，以解决这一核心痛点为目标，通过提供一个全面的、统一的算命占卜工具包 API 接口以及内部采用的 MCP Server 和 skill 来降低应用与服务间的交互复杂度，方便开发者通过公开接口快速集成数据和提示词服务。

核心技术揭秘

Brhiza/mingyu 核心技术栈，包括了 API 接口、MCP Server 以及 skill 系统。API 方面支持 RESTful 风格，通过定义清晰的输入和输出方式来处理各项功能请求，确保低耦合和高内聚性。MCP Server 则是一个轻量级的消息处理器，它允许不同服务间的无缝消息流转。

下面展示了该项目的整体数据流：

graph TD A[用户请求] --> B{"参数校验"} B -->|"通过"| C[执行业务] C --> D[生成提示词] D --> E[封装响应] E --> F[响应用户] B -->|"失败"| G[返回错误信息] G --> F

从上图可以看出，业务逻辑封装和独立的逻辑计算通过 skill 实现，每一项技能（skill）负责一部分计算或处理任务，MCP Server 则起到各个技能间的消息枢纽作用，贯穿整个数据流转过程。

功能亮点与差异

相比于其他分散的算命应用，Brhiza/mingyu 最大的亮点在于它提供的高度集成度以及易用性。使用 Brhiza/mingyu，开发者无需了解任何具体的算命知识，即可快速实现服务集成。技术架构的先进性和内部分层清晰性，让它在同类产品中脱颖而出。

应用场景与落地建议

在生产环境使用 Brhiza/mingyu，最关键的一点是确保 API 接口调用的稳定性与效率，系统响应速度以及数据准确性需要通过全面的测试来进行验证。

此外，整个平台的运维解决方案也需要到位，例如确保 MCP Server 的实时处理能力、稳定性和可靠性。这要求一旦资源瓶颈出现，能通过横向扩展或优化配置等方面快速应对。

在业务场景方面，Brhiza/mingyu 正适用于那些希望在应用中集成一系列算命服务功能的开发者，提供了一套统一接口和标准化数据输出，降低了服务平台间的对接难度。

综合评价

Brhiza/mingyu 作为一款综合了多类算命工具的集成平台，展现了极高的技术能力与使用便利性。然而，任何系统都会存在问题，Brhiza/mingyu 也一样，比如技能复杂度与响应速度之间的平衡问题，以及如何实现特定算命算法的自我学习与优化等。总体来看，其架构设计先进，技术路线合适，非常符合当代开发者需求，为需要将算命服务集成到应用中提供了解决方案。

简要分析

热度分

839

价值分

373

活跃状态

活跃

ai bazi da-liuren divination fortune-telling liuyao mcp mcp-server meihua-yishu prompt-engineering

GitHub

语言占比

CSS

Dockerfile

HTML

Java

JavaScript

TypeScript

Release

贡献者

README

命语 (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）

📿 功德箱

命语与时月东方均为个人业余维护的免费开源项目。

为什么叫“功德箱”？
本项目收到的全部赞助款项目前均定期全额捐赠给社会正规慈善与公益事业（用于爱心助学、困境老人救助与乡村公益等）。感谢每一位支持者的善意！

👉 前往功德箱（赞助与爱心支持）

🌐 在线使用 · 📖 新手教程 · 📚 完整文档 · 🔌 OpenAPI · 📦 mingyu-core (npm)

🔮 支持功能

分类	术数方法	主要功能
命理运势	八字命理、紫微斗数、八字紫微合参、西方星盘、七政四余	支持真太阳时换算、大运流年流月流日细盘、三方四正、庙旺四化、神煞、合盘分析，以及七政行限与流曜
周易占卜	六爻纳甲、梅花易数	支持手摇/指定卦象、京房八宫纳甲、六亲六神、世应动变、体用生克与四时旺衰
三式绝学	奇门遁甲、大六壬、金口诀、太乙神数、皇极经世	支持时家转盘/飞盘奇门、月将天地盘四课三传、阴阳五用、年计七十二局与元会运世
牌卡灵签	西方塔罗牌、雷诺曼牌、三山国王灵签、小六壬	包含 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 在独立产品中接入和使用的实际参考。

在线体验：https://sydf.cc
项目源码：https://github.com/Brhiza/sydf

📚 文档目录

⚖️ 免责声明

本工具提供的排盘结果与 AI 解读提示词仅供传统文化研究与休闲娱乐参考，不构成且不可替代医疗、心理、法律、投资等专业建议。

📄 开源协议

本项目基于 AGPL-3.0-only 协议开源。

mingyu

技术解读

Brhiza/mingyu 项目技术分析

项目背景与痛点

核心技术揭秘

功能亮点与差异

应用场景与落地建议

综合评价

相关仓库

简要分析

语言占比

Release

贡献者

README

命语 (Mingyu)

⚡ 一键接入（Agent 技能 & 在线 MCP）

📿 功德箱

🔮 支持功能

🛠️ 开发者接入

1. 核心算法包 mingyu-core

2. 公开 REST API

3. MCP Server

4. Agent Skill

📱 Android 原生应用

🚀 本地开发与构建

⛩️ 关于三山国王灵签

🌟 基于命语构建

时月东方

📚 文档目录

⚖️ 免责声明

📄 开源协议

评论

1. 核心算法包 `mingyu-core`