命盘 MCP Server

命盘（Mingpan） 是一个中华传统术数 MCP 服务，为 Claude 等 AI 应用提供命理排盘与占卜起卦的计算能力。

特性

• MCP 原生：无缝集成 Claude Desktop 及 Claude Code
• 🌏 中文输出：以简体为主，术语保持传统
• 📊 结构化文本：便于 AI 理解与分析的格式

配置方法

Claude Desktop

找到配置文件并添加以下内容：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

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

Claude Code

claude mcp add mingpan -- npx -y mingpan

验证

配置完成后重启客户端，然后尝试：

请帮我排一个八字命盘，1992年4月12日7点30分，男性

请帮我起一个奇门遁甲时盘，2024年6月21日10点

工具列表

命理排盘

命理学基于出生时间推算人生运势，属于「命」的范畴。

八字命理

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

紫微斗数

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

占卜起卦

占卜术基于起卦时间或随机数推演卦象，属于「卜」的范畴。

六爻

工具	说明
liuyao_basic	六爻排盘（本卦/变卦、纳甲、六亲、六神、世应、旬空）

六爻输入为六个爻值（自下而上）：

• 6 = 老阴（动爻，阴变阳）
• 7 = 少阳（静爻）
• 8 = 少阴（静爻）
• 9 = 老阳（动爻，阳变阴）

梅花易数

工具	说明
meihua_basic	梅花易数排盘（本卦/变卦/互卦、体用分析）

支持两种起卦方式：

• 时间起卦：根据农历年月日时计算
• 数字起卦：根据两个数字计算

大六壬

工具	说明
daliuren_basic	大六壬排盘（天地盘、四课、三传、十二天将、神煞）

大六壬为三式之首，需输入节气、农历月、日干支、时干支。

奇门遁甲

工具	说明
qimen_basic	奇门遁甲排盘（九宫布局、三奇六仪、八门九星八神、格局判断）
qimen_yongshen	奇门用神分析（按事类选取用神，含主客、旺衰、空亡、入墓等）
qimen_zeri	奇门择日（指定日期区间内筛选相对更佳的时机）

奇门遁甲为三式之一，盘式与规则主要参考张志春《神奇之门》，支持：时盘/日盘/月盘/年盘、转盘/飞盘、拆补法/茅山法。

更多说明见：docs/qimen-yongshen-guide.md。

输入参数

命理工具（八字/紫微）

参数	类型	必填	说明
year	number	✓	出生年份（1900-2100）
month	number	✓	出生月份（1-12）
day	number	✓	出生日期（1-31）
hour	number	✓	出生时辰（0-23）
minute	number		出生分钟（0-59），默认 0
gender	string	✓	male / female
longitude	number		出生地经度，用于真太阳时校正
isLunar	boolean		是否为农历输入，默认 false

占卜工具（六爻/梅花/大六壬）

占卜工具使用起卦时间而非出生时间，具体参数请参考各工具说明。

奇门遁甲工具

参数	类型	必填	说明
year	number	✓	起盘年份（1900-2100）
month	number	✓	起盘月份（1-12）
day	number	✓	起盘日期（1-31）
hour	number	✓	起盘时辰（0-23）
minute	number		分钟（0-59），默认 0
isLunar	boolean		是否为农历输入，默认 false
panType	string		时盘 / 日盘 / 月盘 / 年盘，默认 时盘
panStyle	string		转盘 / 飞盘，默认 转盘
zhiRunMethod	string		chaibu（拆补法）/ maoshan（茅山法），默认 chaibu

月份基准说明

系统	月份基准	日期基准
八字	节气月（立春起算）	公历日
紫微	农历月（初一起算）	农历日

开发

git clone https://github.com/ChesterRa/mingpan.git
cd mingpan
npm install
npm run build
npm run dev  # 监听变化

依赖

库	用途
@modelcontextprotocol/sdk	MCP 协议实现
lunar-javascript	农历/公历转换
iztro	紫微斗数计算引擎
zod	输入参数校验

路线图

• [x] 八字基础排盘与时运列表
• [x] 紫微基础排盘与时运列表
• [x] 六爻排盘
• [x] 梅花易数排盘
• [x] 大六壬排盘
• [x] 奇门遁甲排盘

许可证

Apache License 2.0