Mingyu MCP Server

<p align="center"> <a href="https://linux.do" alt="LINUX DO"><img src="https://img.shields.io/badge/LINUX-DO-FFB003.svg" /></a> <a href="https://www.npmjs.com/package/mingyu-core" alt="mingyu-core on npm"><img src="https://img.shields.io/npm/v/mingyu-core?label=mingyu-core&color=CB3837" /></a> <a href="https://github.com/Brhiza/mingyu/actions/workflows/ci.yml" alt="CI"><img src="https://github.com/Brhiza/mingyu/actions/workflows/ci.yml/badge.svg" /></a> </p>

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

---

📿 功德箱

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

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

<p align="center"> <a href="https://lk.sydf.cc/"><strong>👉 前往功德箱（赞助与爱心支持）</strong></a> </p>

---

<p align="center"> <a href="https://aov.cc"><strong>🌐 在线使用</strong></a> · <a href="https://aov.cc/tutorial">📖 新手教程</a> · <a href="docs/README.md">📚 完整文档</a> · <a href="https://aov.cc/api/v1/openapi.json">🔌 OpenAPI</a> · <a href="https://www.npmjs.com/package/mingyu-core">📦 mingyu-core (npm)</a> </p>

---

🔮 支持功能

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

---

📚 文档目录

• 文档总览
• 术数能力与适用范围
• 公开 API 文档
• MCP Server 配置指南
• mingyu-core 算法包说明
• 开发、部署与环境配置

---

⚖️ 免责声明

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

---

📄 开源协议

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