taibu

mcp
Guvenlik Denetimi
Gecti
Health Gecti
  • License — License: NOASSERTION
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 50 GitHub stars
Code Gecti
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested
Purpose

This is a Chinese fortune-telling and divination tool (covering astrology, Tarot, MBTI, etc.) that provides its services via an MCP server so AI assistants can generate readings directly.

Security Assessment

No dangerous patterns were found in the 12 files scanned. The tool doesn't request dangerous permissions or execute shell commands. However, it inherently makes network requests to a Supabase backend and external AI models. Users input birth dates, times, and personal details for readings, so sensitive personal data flows through the service. No hardcoded secrets were detected. Overall risk: Low to Medium — the code itself appears clean, but be aware that personal data (birth info, relationship details) is sent to external services outside your control.

Quality Assessment

The project is actively maintained (last push was today) and has 50 GitHub stars, suggesting a small but real user base. It's written in TypeScript with a modern stack (Next.js, Tailwind, Supabase). The license is marked as NOASSERTION, meaning no clear open-source license is defined — this is a concern if you want to fork or modify it. Documentation is extensive and well-structured, covering many divination systems in detail.

Verdict

Safe to use with caution — the code is clean and the project is active, but be mindful that you're sending personal data to external services, and the lack of a clear license limits reuse rights.
SUMMARY

🔮 高精度AI算命工具,涵盖八字、紫微斗数、六爻、梅花易数、奇门遁甲、大六壬、小六壬、占星术、太乙神数、塔罗、MBTI、面相手相、合盘配对、每日/每月运势、周公解梦等。支持MCP服务和Skills

README.md
MingAI

MingAI - AI命理

将传统命理文化与AI深度融合

Next.js
TypeScript
Tailwind CSS
Supabase
Vercel

Language: 中文 | English

在线体验 · 报告问题


产品亮点

  • 多命理体系 - 八字、六爻、紫微斗数、奇门遁甲、大六壬、梅花易数、塔罗、MBTI、面相、手相、合盘、周公解梦
  • AI智能分析 - 支持导出命理体系文本进行AI分析,多模型支持,深度推理,视觉识别
  • MCP Server - 支持 Model Context Protocol(MCP),可在支持MCP的客户端中直接调用命理工具
  • 历史记录、知识库与@提及 - 支持存储所有命理体系的记录,可将命理体系纳入个人知识库,显式引用命理体系数据源
  • AI个性化 - 表达风格/用户画像/自定义指令 + 上下文、提示词预算可视化
  • 多端体验 - Web + iOS/Android 客户端
  • 社区与激励 - 命理记录、匿名讨论、签到激励

命理功能预览

功能模块 核心特性
八字排盘 · 真太阳时、阳历农历排盘、即时排盘、四柱排盘
· 五行天干地支、十神、藏干、星运、纳音、神煞(51种)、十二长生、刑害合冲
· 天干五合、地支半合、地支三会
· 大运、流年、流月、流日
· 传统分析、盲派分析
紫微斗数 · 十二宫位、三方四正
· 主星、辅星、杂曜、四化(含自化)
· 命主星/身主星、小限、博士十二星
· 旺衰落陷、大限/流年/流月/流日/流时运限分析
· 飞星分析(飞化落宫、三方四正)
奇门遁甲 · 九宫、天地盘、八门、九星、八神
· 值符值使、遁甲类型、局数
· 格局判定(吉/凶)、空亡、驿马、入墓、旺衰
· 转盘排盘,拆补/茅山局法
· 显式时区支持
大六壬 · 天地盘、四课、三传
· 天将(十二神将)、遁干
· 49种神煞、课体分类
· 十二长生、五行旺衰、建除十二神
· 显式时区,支持本命/行年
六爻占卜 · 硬币起卦、快速起卦、选卦起卦、时间起卦、数字起卦
· 爻变明动、暗动
· 卦辞、爻辞、象辞
· 用神、原神、伏神、仇神
· 空亡 · 世应、旺衰状态、刑冲合害
· 互卦、错卦、综卦
· 应期推测
梅花易数 · 年月日時起卦、物数/声数、字占、丈尺尺寸、方位类象
· 两数/三数报数扩展法
· 本卦、互卦、变卦、错卦、综卦、动爻
· 体卦/用卦、体用生克、月令旺衰、克应层次
· 应期线索、定性吉凶判断
塔罗占卜 · 9种牌阵:单牌、三牌阵、爱情牌阵、凯尔特十字、马蹄、抉择、身心灵、情境、是/否
· 逆位判定、78张完整牌面解读、精美卡牌
· 星座/元素对应、数字命理(人格牌/灵魂牌/年份牌)
· 每日运势指引
关系合盘 · 情侣、商业、亲子
· 未来运势走线
· 沟通建议
面相、手相 · 天庭、鼻相、眼相、口相
· 生命线、智慧线、事业线、感情线
运势中心 · 基于命盘的每日、每月运势分析
· 每日黄历(含方位系统、12时辰吉凶、二十八星宿)
· 未来运势走线
MBTI性格测试 · 90+道性格测试题
· 综合AI分析性格
高度AI集成 · 根据过往占卜综合分析
· 命理体系全分析
· 知识库、附件、搜索
· 支持AI对话时提及所有命理体系
· 年度命理报告

MCP

MingAI 提供 MCP,可在支持 MCP 的客户端中直接调用命理工具。

快速配置

配置中添加以下内容即可使用

{
  "mcpServers": {
    "mingai": {
      "command": "npx",
      "args": ["-y", "@mingai/mcp"]
    }
  }
}

支持的工具

工具 功能 提问例子
bazi 八字排盘(支持阳历/农历,51种神煞,天干五合,地支半合/三会,胎元/命宫) "我是1990年5月15日15点生,请帮我排盘"
bazi_pillars_resolve 八字反查(四柱 → 出生时间候选,1900-2100) "我的八字是丙午庚寅丙辰癸巳,请帮我分析"
bazi_dayun 八字大运计算(十年大运周期,流年详情,太岁标注,小运) AI会自动分析你的八字调用计算
ziwei 紫微斗数排盘(含命主星/身主星,小限,博士12星,三方四正) "我是农历1990年4月初八生,请排紫微盘"
ziwei_horoscope 紫微运限(大限/小限/流年/流月/流日/流时,流年星曜) "帮我看看2026年的紫微运限"
ziwei_flying_star 紫微飞星分析(飞化/自化/四化落宫/三方四正) "分析一下我命宫的飞星"
liuyao 六爻占卜(支持起卦/自主选卦/时间起卦/数字起卦,含互卦/错卦/综卦) "我想占卜今年的事业运,请帮我起卦分析"
meihua 梅花易数(支持年月日時、物数/声数、字占、丈尺尺寸、方位类象、两数/三数报数) "现在起一卦,用梅花易数看这次合作能不能成"
tarot 塔罗抽牌(9种牌阵,78张完整牌面,独立逆位关键词,星座/元素对应) "请为我抽一张塔罗牌,关于近期的爱情运势"
almanac 黄历查询(含方位系统,12时辰吉凶,二十八星宿) "今天的黄历怎么样?适合求婚吗?"
astrology 西方占星命盘与流运(命盘三巨头、本命主星、重大流运触发) "帮我看一下这段时间的占星流运重点"
qimen 奇门遁甲排盘(九宫、八门、九星、八神、值符值使、显式时区) "用奇门看一下今天谈合作是否顺利"
taiyi 太乙九星观测(外部时空环境、九星阵列、能量交互) "用太乙九星看一下这个项目推进情况"
daliuren 大六壬排盘(四课三传、天地盘、神将、显式时区) "用大六壬看一下这件事的结果"
xiaoliuren 小六壬占测(起课结果、宫位落点、核心断事线索) "用小六壬看一下今天出行顺不顺"

SDK

如果你想在自己的 Node.js 项目中直接调用计算引擎(无需 MCP 协议),可以使用核心库:

npm install @mingai/core

详见 @mingai/core npm 页面


快速开始

Docker 部署

支持三种方式:

# 准备环境变量(首次)
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

默认端口:

开发环境部署

环境要求:

  • Node.js 18+
  • pnpm (推荐) / npm / yarn
# 克隆项目
git clone [email protected]:hhszzzz/MingAI.git
cd MingAI

# 安装依赖
pnpm install

# 配置环境变量
cp .env.example .env
# 编辑 .env 填入必要的 API Keys

# 启动开发服务器
pnpm dev

访问 http://localhost:3000 查看应用。


贡献

欢迎提交 Issue 和 Pull Request!


许可证

本仓库采用混合许可证:

  • packages/core
  • packages/mcp
  • packages/mcp-server

以上三个包采用 MIT 许可证,详见各自目录下的 LICENSE 文件。

除上述三个包外,仓库其余 Web、服务端、部署与运行时代码采用 AGPL-3.0-only,详见仓库根目录 LICENSE

提示:

  • AGPL-3.0-only 不禁止商用,但要求修改后的网络服务在对外提供时履行相应源码开放义务
  • MIT 包允许商用、再分发与二次开发,但需保留版权与许可声明

MingAI - 用AI解读命运,用科技传承文化

Made with ❤️ by hhszzzz

Yorumlar (0)

Sonuc bulunamadi