命盘 MCP Server
](https://github.com/ChesterRa/mingpan) 
命盘（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