by Brhiza
Provides a one‑stop solution for Chinese and Western divination, generating comprehensive charts (八字, 紫微, 星盘, 六爻, 梅花, 奇门, 大/小六壬, 塔罗, 雷诺曼, 灵签, 择日) together with structured data and AI‑ready prompt text. Available through a web UI, public REST API, MCP server, and a reusable skill for AI agents.
Mingyu offers an integrated platform that calculates traditional Chinese metaphysics charts, Western astrological natal charts, and various divination methods, then converts the results into machine‑readable JSON and concise prompt strings suitable for large language models.
https://aov.cc/api/v1 with the appropriate payload (e.g., type: "bazi", date, gender). The response contains result (structured data) and prompt (text for LLMs).mcp/README.md). Clients that understand the Model Context Protocol can call the local engine directly, receiving the same result/prompt payload.aov-mingyu-api) to an AI agent platform (e.g., via npx skills add Brhiza/mingyu --skill aov-mingyu-api -g -y). The agent can then invoke Mingyu functions through the skill’s defined actions.customDate parameter.Q: Do I need to install anything to call the API?
A: No. The public API is hosted at https://aov.cc/api/v1. Just send HTTP requests.
Q: How can I run the engine locally?
A: Clone the repo, run pnpm install, then start the MCP server with npm run mcp (or the equivalent npx command as described in mcp/README.md).
Q: Is there a free tier? A: The web UI and public API are free for personal use. Server‑side AI integration requires your own API key and will incur the respective provider’s costs.
Q: What languages are supported? A: The core calculations are language‑agnostic; the UI and documentation are primarily in Chinese, but the JSON schema and OpenAPI definition are language‑neutral.
Q: Can I customize the prompt format?
A: Yes. The API returns the raw data, and you can construct your own prompt template or use the built‑in prompt field as a ready‑made version.
命语是一个算命、占卜、择日的提示词生成项目,目标是把排盘、起卦、抽牌、结构化数据和 AI 提示词连接成一条清晰可复用的流程。让所有人都可以快速的生成专业可靠的排盘信息,而不是依靠模糊的关键词和无脑堆叠专业词汇,让AI占卜相对更加可靠,享受术数的神秘智慧。
你可以在网页端快速完成排盘或占卜,时间类占卜支持使用当前时间或自定北京时间,并复制提示词给你常用的所有 AI 工具继续解读;对于移动端用户还可以使用分享功能快速跳转;也可以通过公开 API、MCP Server 或 skill,把命语的排盘与提示词能力接入自己的应用、工作流和智能体系统。
项目目前覆盖八字排盘、紫微斗数、星盘、六爻、梅花易数、奇门遁甲、大六壬、小六壬、塔罗牌、雷诺曼、三山国王灵签、择日等场景,并尽量将结果拆分为机器可读的数据、用户可理解的摘要和适合大模型继续分析的提示词。
线上体验:https://aov.cc
公开 API:https://aov.cc/api/v1/manifest
OpenAPI:https://aov.cc/api/v1/openapi.json
公开 skill:https://aov.cc/skills/aov-mingyu-api/SKILL.md
iztro 的完整命盘,支持本命、大限、流年、流月、流日、流时等数据范围,支持三合派、飞星派、四化派流派指引。customDate 传入带时区的 ISO 8601 时间。2025年第十六届全球算命师比赛 评测资料,包含原题、8 份提示词和 40 题正确答案。命语提供三种集成方式:公开 API、MCP Server、公开 skill。API 和 MCP 都支持一站式返回 result 与 prompt;六爻、梅花易数、奇门遁甲、大六壬、小六壬还支持通过 customDate 指定起卦或排盘时间。README 只保留快速入口和安装方式,接口参数、客户端配置和调用示例请跳转到对应文档。
无需安装,直接调用线上接口:
https://aov.cc/api/v1
详细文档:docs/api.md
OpenAPI:https://aov.cc/api/v1/openapi.json
命语内置 MCP Server,让支持 MCP 的 AI 客户端直接调用本地排盘引擎,不需要用户手动复制 JSON 或提示词。
快速安装:
git clone https://github.com/Brhiza/mingyu.git
cd mingyu
npm install
启动命令:
npm run mcp
详细文档:mcp/README.md
这个 skill 面向 AI 代理和开发者,说明如何通过 aov.cc 公开 API 完成排盘、占卜和提示词生成。
快速安装:
npx skills add Brhiza/mingyu --skill aov-mingyu-api -g -y
快速读取:
让你的 AI 代理读取这个 skill:
https://aov.cc/skills/aov-mingyu-api/SKILL.md
如果当前环境无法使用 npx skills,也可以手动创建目录后保存:
mkdir -p ~/.codex/skills/aov-mingyu-api
curl -L https://aov.cc/skills/aov-mingyu-api/SKILL.md \
-o ~/.codex/skills/aov-mingyu-api/SKILL.md
Windows PowerShell:
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex\skills\aov-mingyu-api"
Invoke-WebRequest "https://aov.cc/skills/aov-mingyu-api/SKILL.md" `
-OutFile "$env:USERPROFILE\.codex\skills\aov-mingyu-api\SKILL.md"
详细文档:public/skills/aov-mingyu-api/SKILL.md
元数据发现:https://aov.cc/.well-known/aov-mingyu-api.json
mingyu-core命语的所有命理排盘与占卜算法已抽取为独立 npm 包 mingyu-core,本仓库以 pnpm workspace 形式同时维护应用与算法包。
mingyu/
├── packages/
│ └── core/ # mingyu-core 算法包(独立发布到 npm)
└── src/ # 应用层(React + Vite + MCP)
安装:
npm install mingyu-core
使用示例:
// 八字排盘
import { baziCalculator } from 'mingyu-core/bazi';
const result = baziCalculator.calculateBazi({
year: 1990, month: 1, day: 1, timeIndex: 5, gender: 'male',
});
// 占卜算法
import { generateLiuyao } from 'mingyu-core/divination/liuyao';
import { generateQimen } from 'mingyu-core/divination/qimen';
import { generateLiuren } from 'mingyu-core/divination/liuren';
// 历法工具
import { getDivinationTime, getVoidBranches } from 'mingyu-core/calendar';
// 类型
import type { BaziChartResult, QimenData, LiurenData } from 'mingyu-core/types';
包覆盖能力:八字(含调候用神、格局、神煞、大运及透干根气、十神结构、合化评估、命卦、小运等增强分析)、奇门遁甲(含节令背景、复合格局、方位应期)、六爻、大六壬、梅花易数、小六壬、紫微斗数、西洋占星、择日、雷诺曼、塔罗、三山国王灵签。
⚠️ 免责: 该包仅提供算法实现,所有结果仅供参考与学习娱乐,不构成任何命理预测或专业建议。
算法包详细文档:packages/core/README.md
| 类别 | 技术 |
|---|---|
| 前端 | React 19、TypeScript 5.9 |
| 构建 | Vite 7 |
| 路由 | React Router 7 |
| 包管理 | pnpm workspace(应用层 + mingyu-core 算法包) |
| 部署 | Cloudflare Pages、Pages Functions、Docker |
| 历法与星盘 | tyme4ts、iztro、celestine |
| 数据校验 | zod |
| 测试 | Node.js 原生测试运行器 |
| AI 集成 | MCP Server、OpenAPI、skill 文档 |
mingyu/
├── functions/ # Cloudflare Pages Functions 公开 API
├── mcp/ # MCP Server
├── packages/
│ └── core/ # mingyu-core 独立算法包(发布到 npm)
│ ├── src/bazi/ # 八字引擎与增强分析
│ ├── src/divination/ # 占卜算法(六爻/奇门/六壬/梅花等)
│ ├── src/calendar/ # 历法工具
│ └── src/types/ # 共享类型
├── public/
│ ├── .well-known/ # 公开发现元数据
│ └── skills/ # 公开 skill 文档
├── server/ # Docker 自部署服务入口
├── src/
│ ├── components/ # 页面组件与通用 UI
│ ├── lib/
│ │ ├── divination/ # 占卜引擎与提示词拼装
│ │ ├── full-chart-engine/ # 八字、紫微完整排盘入口
│ │ ├── iztro/ # 紫微运行时适配
│ │ ├── public-api/ # 公开 API handler
│ │ └── ziwei-prompts/ # 紫微提示词模块
│ ├── pages/ # 输入页、结果页、历史页、教程页
│ ├── types/ # 领域类型定义
│ ├── utils/ # 八字、塔罗、历法、灵签等工具
│ └── workers/ # 紫微相关 Web Worker
└── tests/ # 单元测试与集成测试
本项目支持本地开发、Cloudflare Pages 和 Docker 三种常用运行方式。AI 相关变量也放在这里,部署时可以一起配置。
本项目使用 pnpm workspace 管理应用层与 mingyu-core 算法包,需先安装 pnpm:
npm install -g pnpm
安装依赖:
pnpm install
启动网页开发服务:
pnpm dev
启动 MCP Server:
pnpm mcp
构建生产版本:
pnpm build
运行测试:
pnpm test
单独构建 mingyu-core 算法包:
pnpm --filter mingyu-core build
类型检查 MCP 与共享源码:
npx tsc --project mcp/tsconfig.json --noEmit
推荐部署到 Cloudflare Pages,静态页面由 Pages 托管,/api/v1/* 由 Pages Functions 处理。
Pages 构建设置:
| 配置项 | 值 |
|---|---|
| Build command | pnpm build |
| Build output directory | dist |
| Root directory | 仓库根目录 |
| Node.js version | 建议 22 |
如果 Cloudflare 没有自动启用 pnpm,可在环境变量中添加:
PNPM_VERSION=10
公开 API 路由来自 functions/api/v1/[[path]].ts,部署后可访问:
https://你的域名/api/v1/manifest
https://你的域名/api/v1/openapi.json
Cloudflare Pages 的环境变量在 Dashboard → Settings → Environment variables 中配置。密钥不要写进代码仓库。
Docker 镜像会构建前端页面,并在容器内启动一个 Node 服务,同时提供:
/api/v1/* 公开 API/api/v1/ai/analyze 流式 AI 解读/api/v1/ai/models 模型列表获取构建镜像:
docker build -t mingyu .
启动基础服务:
docker run --rm -p 3000:3000 mingyu
访问:
http://localhost:3000
带服务端 AI 启动:
docker run --rm -p 3000:3000 \
-e AI_API_KEY=sk-xxx \
-e AI_BASE_URL=https://api.deepseek.com/v1 \
-e AI_MODEL=deepseek-chat \
-e AI_PROVIDER_NAME=DeepSeek \
-e AI_BUILTIN_ENABLED=true \
-e AI_DEFAULT_ENABLED=false \
mingyu
也可以使用 Docker Compose:
docker compose up --build
Compose 会读取本地 .env。可以在本地 .env 中填写下面内容,但不要提交这个文件:
AI_API_KEY=sk-xxx
AI_BASE_URL=https://api.deepseek.com/v1
AI_MODEL=deepseek-chat
AI_PROVIDER_NAME=DeepSeek
AI_BUILTIN_ENABLED=true
AI_DEFAULT_ENABLED=false
默认端口是 3000。如需修改容器内端口,可设置 PORT;如需修改宿主机端口,调整 compose 或 docker run 的 -p 左侧端口。
命语支持两种 AI 使用方式:
服务端 AI 环境变量:
| 变量 | 说明 |
|---|---|
AI_API_KEY |
服务端调用模型的密钥 |
AI_BASE_URL |
OpenAI 兼容接口地址,例如 https://api.deepseek.com/v1 |
AI_MODEL |
默认模型名称 |
AI_PROVIDER_NAME |
前端显示的服务商名称,可自行命名 |
AI_BUILTIN_ENABLED |
设为 true 时,前端显示并允许使用服务端 AI |
AI_DEFAULT_ENABLED |
设为 true 时,页面默认进入 AI 解读;设为 false 时默认仍是提示词模式 |
只配置 AI_API_KEY 不会自动显示服务端 AI;必须同时设置 AI_BUILTIN_ENABLED=true。如果想提供公益内置 AI,但默认仍让用户复制提示词,可设置 AI_BUILTIN_ENABLED=true、AI_DEFAULT_ENABLED=false。用户仍可通过齿轮自行填写自己的接口。
AI 代理会对上游临时错误自动重试 2 次。只重试网络异常、408、429 和 5xx;鉴权失败、模型名错误等确定性问题不会重试。常见错误码:
| 错误码 | 含义 |
|---|---|
AI_UPSTREAM_UNSTABLE |
上游 AI 服务返回 5xx,通常是服务临时不稳定 |
AI_UPSTREAM_RATE_LIMIT |
上游限流或额度受限 |
AI_UPSTREAM_TIMEOUT |
上游响应超时 |
AI_UPSTREAM_AUTH_ERROR |
API Key 无效、过期或额度账号异常 |
AI_UPSTREAM_CONFIG_ERROR |
接口地址或模型名称可能不被上游支持 |
AI_UPSTREAM_NETWORK_ERROR |
服务器无法连接上游 AI 服务 |
AI_UPSTREAM_EMPTY_RESPONSE |
上游返回成功状态但没有可读取内容 |
AI_UPSTREAM_STREAM_ERROR |
上游流式响应中途断开 |
.dev.vars.example 提供了本地和 Cloudflare 可参考的变量模板。公开站点启用服务端 AI 会产生调用成本,也可能受上游模型稳定性影响,建议先确认额度、限流和可用性。
比赛资料位于:docs/2025第十六届全球算命师比赛
交互式运行:
npm run contest:evaluate
脚本会依次询问接口 URL、API Key 和模型名称,自动读取 8 份提示词与 正确答案.md。每个命例只要求模型输出 5 个 A/B/C/D 答案字母,减少长理由导致的截断和解析错误;调用完成后输出 100 分制总分、准确率、分命例得分和逐题明细。
也可以直接传参:
npm run contest:evaluate -- --format chat --url https://api.openai.com/v1 --key sk-xxx --model gpt-4.1-mini
批量并发评测:
npm run contest:evaluate -- --format chat --url https://openrouter.ai/api/v1 --key sk-xxx --concurrency 3 --models "GPT-5.4=openai/gpt-5.4,Claude Sonnet 4.6=anthropic/claude-sonnet-4.6"
--concurrency 控制同时评测的模型数量,默认批量为 3;--caseConcurrency 控制同一模型内命例并发数量,默认 1。批量模式会合并更新比赛目录下的 模型评测排名报告.md 和 评测结果/本次排名原始结果.json。
使用 OpenRouter 测 reasoning 模型时,可以加 --reasoningEffort none --excludeReasoning --maxTokens 256,让模型尽量只返回最终答案。若某个命例没有解析满 5 个答案,脚本会把该模型标为失败,不会把 ????? 当作 0 分答案计入排名。
支持的 --format:
| 格式 | 说明 | URL 示例 |
|---|---|---|
chat |
OpenAI Chat Completions 或兼容接口 | https://api.openai.com/v1 |
responses |
OpenAI Responses | https://api.openai.com/v1 |
claude |
Claude Messages | https://api.anthropic.com/v1 |
gemini |
Gemini generateContent | https://generativelanguage.googleapis.com/v1beta |
不传 --format 时会自动识别;评测报告会保存到比赛资料目录下的 评测结果/。
三山国王是粤东潮汕与客家地区极具影响力的民间信仰,祖庙位于广东揭西县河婆街道。这座有着千年历史的庙宇供奉着巾山、明山、独山三位山神,自隋代至今香火不断,影响远播东南亚。
项目作者来自揭西,自幼祭拜三山国王。这套92 签灵签体系正是以祖庙传承的签诗为本,结合正史典故与民间传说整理而成:
我们希望这套签文能成为一本"人生操作手册"——迷茫时翻开,总有一支签、一句诗,能让人豁然开朗。
命语提供的是命理、占卜与 AI 提示词辅助工具,结果仅供参考和娱乐学习使用,不应替代医疗、法律、投资、心理咨询等专业建议。
算命、AI 算命、在线算命、免费算命、智能算命、八字算命、八字排盘、紫微斗数、紫微排盘、星盘、占星排盘、六爻起卦、梅花易数、奇门遁甲、大六壬、小六壬、塔罗占卜、塔罗抽牌、雷诺曼、抽签、灵签、三山国王灵签、择日、黄道吉日、命理工具、占卜工具、运势分析、婚姻算命、事业运势、财运分析。
Please log in to share your review and rating for this MCP.
Explore related MCPs that share similar capabilities and solve comparable challenges
by mattt
Enables AI assistants to retrieve and manage personal macOS data such as calendar events, contacts, messages, reminders, location, maps, and weather through a local MCP server, allowing personalized AI interactions without sending data off‑device.
by nspady
Provides Google Calendar integration for AI assistants, enabling event listing, creation, updating, deletion, free/busy queries, recurring event handling, and smart scheduling via natural language.
by baidu-maps
Offers a comprehensive suite of geospatial APIs and tools for developers and AI agents, enabling geocoding, reverse geocoding, POI search, route planning, weather, traffic, IP location, and real‑time traffic queries via standardized MCP interfaces.
by Omar-V2
Interact with the macOS Calendar through natural‑language commands, enabling creation, querying, and updating of events in a conversational way.
by zcaceres
Integrates with Google Tasks to list, read, search, create, update, and delete tasks via MCP tools.
by GongRzhe
Enables LLMs to perform travel-related tasks such as location search, place details lookup, route calculation, and timezone retrieval using Google Maps services.
by v-3
Interact with Google Calendar to list, create, update, delete events and find free time slots via Claude.
by r-huijts
Provides real-time Dutch railway travel information—including departures, arrivals, journey planning, pricing, and station facilities—through an MCP server that Claude can query.
by isdaniel
Provides current weather, historical weather ranges, and timezone‑aware current datetime for specified cities using the free Open‑Meteo API.