- 多命理体系 - 八字、六爻、紫微斗数、奇门遁甲、大六壬、塔罗、MBTI、面相、手相、合盘、周公解梦
- AI智能分析 - 支持导出命理体系文本进行AI分析，多模型支持，深度推理，视觉识别
- MCP Server - 支持 Model Context Protocol（MCP），可在支持MCP的客户端中直接调用命理工具
- 历史记录、知识库与@提及 - 支持存储所有命理体系的记录，可将命理体系纳入个人知识库，显式引用命理体系数据源
- AI个性化 - 表达风格/用户画像/自定义指令 + 上下文、提示词预算可视化
- 多端体验 - Web + iOS/Android 客户端
- 社区与激励 - 命理记录、匿名讨论、签到激励
| 功能模块 | 核心特性 |
|---|---|
| 八字排盘 | · 真太阳时、阳历农历排盘、即时排盘、四柱排盘 · 五行天干地支、十神、藏干、星运、纳音、神煞（51种）、十二长生、刑害合冲 · 天干五合、地支半合、地支三会 · 大运、流年、流月、流日 · 传统分析、盲派分析 |
| 紫微斗数 | · 十二宫位、三方四正 · 主星、辅星、杂曜、四化（含自化） · 命主星/身主星、小限、博士十二星 · 旺衰落陷、大限/流年/流月/流日/流时运限分析 · 飞星分析（飞化落宫、三方四正） |
| 奇门遁甲 | · 九宫、天地盘、八门、九星、八神 · 值符值使、遁甲类型、局数 · 格局判定（吉/凶）、空亡、驿马、入墓、旺衰 · 转盘排盘，拆补/茅山局法 · 显式时区支持 |
| 大六壬 | · 天地盘、四课、三传 · 天将（十二神将）、遁干 · 49种神煞、课体分类 · 十二长生、五行旺衰、建除十二神 · 显式时区，支持本命/行年 |
| 六爻占卜 | · 硬币起卦、快速起卦、选卦起卦、时间起卦、数字起卦 · 爻变明动、暗动 · 卦辞、爻辞、象辞 · 用神、原神、伏神、仇神 · 空亡 · 世应、旺衰状态、刑冲合害 · 互卦、错卦、综卦 · 应期推测 |
| 塔罗占卜 | · 9种牌阵：单牌、三牌阵、爱情牌阵、凯尔特十字、马蹄、抉择、身心灵、情境、是/否 · 逆位判定、78张完整牌面解读、精美卡牌 · 星座/元素对应、数字命理（人格牌/灵魂牌/年份牌） · 每日运势指引 |
| 关系合盘 | · 情侣、商业、亲子 · 未来运势走线 · 沟通建议 |
| 面相、手相 | · 天庭、鼻相、眼相、口相 · 生命线、智慧线、事业线、感情线 |
| 运势中心 | · 基于命盘的每日、每月运势分析 · 每日黄历（含方位系统、12时辰吉凶、二十八星宿） · 未来运势走线 |
| MBTI性格测试 | · 90+道性格测试题 · 综合AI分析性格 |
| 高度AI集成 | · 根据过往占卜综合分析 · 命理体系全分析 · 知识库、附件、搜索 · 支持AI对话时提及所有命理体系 · 年度命理报告 |
MingAI 提供 MCP (Model Context Protocol) ，可在支持 MCP 的客户端中直接调用命理工具。
在 Claude Desktop / Cherry Studio 等客户端的 MCP 配置中添加以下内容即可使用，无需手动下载，仅需本机安装 Node.js 18+：
{
"mcpServers": {
"mingai": {
"command": "npx",
"args": ["-y", "@mingai/mcp"]
}
}
}| 工具 | 功能 | 提问例子 |
|---|---|---|
bazi_calculate |
八字排盘（支持阳历/农历，51种神煞，天干五合，地支半合/三会，胎元/命宫） | "我是1990年5月15日15点生，请帮我排盘" |
bazi_pillars_resolve |
八字反查（四柱 → 出生时间候选，1900-2100） | "我的八字是丙午庚寅丙辰癸巳，请帮我分析" |
bazi_dayun |
八字大运计算（十年大运周期，流年详情，太岁标注，小运） | AI会自动分析你的八字调用计算 |
ziwei_calculate |
紫微斗数排盘（含命主星/身主星，小限，博士12星，三方四正） | "我是农历1990年4月初八生，请排紫微盘" |
ziwei_horoscope |
紫微运限（大限/小限/流年/流月/流日/流时，流年星曜） | "帮我看看2026年的紫微运限" |
ziwei_flying_star |
紫微飞星分析（飞化/自化/四化落宫/三方四正） | "分析一下我命宫的飞星" |
liuyao |
六爻占卜（支持起卦/自主选卦/时间起卦/数字起卦，含互卦/错卦/综卦） | "我想占卜今年的事业运，请帮我起卦分析" |
tarot |
塔罗抽牌（9种牌阵，78张完整牌面，独立逆位关键词，星座/元素对应） | "请为我抽一张塔罗牌，关于近期的爱情运势" |
almanac |
黄历查询（含方位系统，12时辰吉凶，二十八星宿） | "今天的黄历怎么样？适合求婚吗？" |
qimen_calculate |
奇门遁甲排盘（九宫、八门、九星、八神、值符值使、显式时区） | "用奇门看一下今天谈合作是否顺利" |
daliuren |
大六壬排盘（四课三传、天地盘、神将、显式时区） | "用大六壬看一下这件事的结果" |
如果你想在自己的 Node.js 项目中直接调用计算引擎（无需 MCP 协议），可以使用核心库：
npm install @mingai/core详见 @mingai/core npm 页面 与 packages/core/README.md。
支持三种方式：
# 准备环境变量（首次）
cp .env.example .env
# 1) 一键部署：同时启动 Web + MCP
docker compose up -d --build
# 2) 仅部署 Web
docker compose -f docker-compose.web.yml up -d --build
# 3) 仅部署 MCP Server
docker compose -f docker-compose.mcp.yml up -d --build默认端口：
- Web:
3000（http://localhost:3000） - MCP:
3001
环境要求：
- Node.js 18+
- pnpm (推荐) / npm / yarn
# 克隆项目
git clone git@github.com:hhszzzz/MingAI.git
cd MingAI
# 安装依赖
pnpm install
# 配置环境变量
cp .env.example .env
# 编辑 .env 填入必要的 API Keys
# 启动开发服务器
pnpm dev访问 http://localhost:3000 查看应用。
| 文档 | 说明 |
|---|---|
| PRD | 产品需求文档 |
| MCP 使用手册 | MCP 详细操作指南 |
- 七政四余
- 梅花易数
- 姓名学
欢迎提交 Issue 和 Pull Request！
本项目仅供学习交流使用。
MingAI - 用AI解读命运，用科技传承文化
Made with ❤️ by hhszzzz