Skip to content

Releases: ChesterRa/mingpan

v0.1.3

30 Dec 12:45

Choose a tag to compare

v0.1.3 Release Notes

本版本为 v0.1.3,主要新增并完善 奇门遁甲(时家奇门) 能力,面向 MCP 场景提供排盘、用神分析与择日支持。

主要更新

  1. 奇门遁甲能力上线
 - 新增 奇门遁甲排盘:九宫布局、三奇六仪、八门、九星、八神、旬首/空亡、格局检测等。
 - 支持多种盘类与盘式:
   - 盘类:时盘 / 日盘 / 月盘 / 年盘
   - 盘式:转盘 / 飞盘
 - 支持置闰算法:
   - 拆补法(chaibu)
   - 茅山法(maoshan)
 - 盘面输出新增专用的 Markdown/ASCII 九宫渲染,便于 AI/人类快速阅读与分析。
  1. 用神系统(按事类选取与分析)
 - 新增 奇门用神分析工具:按事类自动选取主用神/辅用神。
 - 提供用神状态评估:旺衰、空亡、入墓、主客(我/彼)关系等要点输出。
 - 增加配套文档:docs/qimen-yongshen-guide.md。
  1. 择日能力
 - 新增 奇门择日工具:在指定日期区间内筛选相对更佳的时机(可按事类、评分阈值、数量限制等参数控制),并可选输出方位信息。

工具新增

 - qimen_basic:奇门遁甲排盘
 - qimen_yongshen:奇门用神分析
 - qimen_zeri:奇门择日

非常感谢@waterbang的贡献!

命盘 MCP Server v0.1.2

19 Dec 09:59

Choose a tag to compare

发布日期: 2024-12-19

🎉 新增功能

本版本新增三大占卜术数系统,将命盘从纯命理工具扩展为完整的中华术数平台。

六爻排盘 (liuyao_basic)

六爻是中国传统占卜术,通过摇卦得出六个爻值,推演吉凶。

功能特点:

  • 本卦/变卦计算(含卦名、卦宫、五行)
  • 纳甲系统(每爻地支及五行)
  • 六亲配置(父母/兄弟/子孙/妻财/官鬼)
  • 六神排列(青龙/朱雀/勾陈/螣蛇/白虎/玄武)
  • 世应位置标注
  • 动爻与旬空计算
  • 伏神显示

梅花易数排盘 (meihua_basic)

梅花易数是宋代邵雍所创的占卜方法,以简洁著称。

功能特点:

  • 时间起卦(根据农历年月日时)
  • 数字起卦(根据两个数字)
  • 本卦/变卦/互卦计算
  • 体用分析(体卦、用卦、五行生克关系)
  • 起卦数据详情

大六壬排盘 (daliuren_basic)

大六壬为三式之首,与奇门遁甲、太乙神数并称,是最古老的占卜术之一。

功能特点:

  • 天地盘排布(月将加时辰)
  • 四课推演(日干支推演)
  • 三传计算(九宗门:贼克、比用、涉害、遥克、昴星、别责、八专、伏吟、返吟)
  • 十二天将配置
  • 格局判断
  • 神煞计算(日马、月马、丁马、华盖、闪电)

命盘 MCP Server v0.1.1

18 Dec 03:36

Choose a tag to compare

首次公开发布 | 2025-12-18

📌 概述

命盘(Mingpan)是一个基于 MCP(Model Context Protocol)协议的中华传统命理计算服务,为 Claude 等 AI 应用提供专业的八字与紫微斗数排盘能力。

✨ 功能特性

八字命理(5 个工具)

工具 说明
bazi_basic 八字命盘排盘(四柱、藏干、十神、五行力量)
bazi_dayun 大运列表(十年一运)
bazi_liunian 流年列表(指定年份范围)
bazi_liuyue 流月列表(节气月,立春起算)
bazi_liuri 流日列表(指定月份内每日)

紫微斗数(6 个工具)

工具 说明
ziwei_basic 紫微命盘排盘(十二宫、主星、辅星、四化)
ziwei_daxian 大限列表(十年一限)
ziwei_xiaoxian 小限列表(每年一宫)
ziwei_liunian 流年列表(指定年份范围)
ziwei_liuyue 流月列表(农历月)
ziwei_liuri 流日列表(农历日)

🔧 技术特点

  • MCP 原生:无缝集成 Claude Desktop 及 Claude Code
  • 繁体中文输出:符合命理传统的专业术语
  • 结构化文本:便于 AI 理解与分析的格式
  • 真太阳时支持:可传入经度进行时差校正

📦 安装使用

Claude Desktop

{
  "mcpServers": {
    "mingpan": {
      "command": "npx",
      "args": ["-y", "mingpan"]
    }
  }
}

Claude Code

claude mcp add mingpan -- npx -y mingpan

🔗 链接

📄 许可证

Apache License 2.0