命盘 MCP Server

简体中文（主文档） | English | 日本語

命盘（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`	八字四柱排盘（干支纳音、天干/藏干十神、十二长生自坐、命宫/胎元、旬空、公农历对照；五行/格局/用神由 AI 分析）
`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`	大六壬排盘（天地盘、四课、三传、十二天将、神煞）

大六壬为三式之首。推荐直接输入公历起课时间（year/month/day/hour），
节气、月将、日干支、时干支由系统自动推得（LLM 手推干支极易出错）。
也可显式指定 jieqi/dayGanZhi/hourGanZhi（专家模式，向后兼容）。

奇门遁甲

工具	说明
`qimen_basic`	奇门遁甲排盘（九宫布局、三奇六仪、八门九星八神、格局检测）
`qimen_yongshen`	奇门用神分析（按事类选取用神，含主客、旺衰、空亡、入墓等确定性信息）

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

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

输出示例（bazi_basic）

=== 命主資料 ===
性別：男
公曆：1992-04-12 07:30:00
農曆：壬申年三月初十辰時

=== 八字命盤 ===
年柱：壬申（剑锋金）  月柱：甲辰（覆灯火）  日柱：戊午（天上火）  時柱：丙辰（沙中土）
日柱旬空：子丑
命宮：己酉　胎元：乙未
天干十神：年干水=偏財　月干木=七殺　時干火=偏印
藏干十神（※本氣）：年申[庚食神※ 壬偏財 戊比肩]　月辰[戊比肩※ 乙正官 癸正財]　日午[丁正印※ 己劫財]　時辰[戊比肩※ 乙正官 癸正財]
十二長生（自坐）：年长生　月衰　日帝旺　時冠带

只包含确定性排盘信息；五行强弱、格局、用神等解读由 AI 依据盘面自行分析。

输入参数

命理工具（八字/紫微）

参数	类型	必填	说明
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
timezone	string		IANA 时区名（如 `America/New_York`），默认北京时间

时区说明（v0.1.4 新增）

输入时间默认按北京时间排盘
海外出生/起卦时提供 timezone 参数，系统将当地墙钟时间换算为北京时间后计算
输入侧使用 IANA 时区数据库（正确处理各国历史夏令时，如 1986-1991 年中国夏令时）
内部规范表示为 UTC+8 平太阳时，与历法换算口径一致

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

六爻/梅花：输入起卦时间（支持 timezone），爻值/卦数由调用方提供
大六壬：推荐直接输入公历时间，节气与干支自动推得；也可显式指定（专家模式）

奇门遁甲工具

参数	类型	必填	说明
year	number	✓	起盘年份（1900-2100）
month	number	✓	起盘月份（1-12）
day	number	✓	起盘日期（1-31）
hour	number	✓	起盘时辰（0-23）
minute	number		分钟（0-59），默认 0
isLunar	boolean		是否为农历输入，默认 false
timezone	string		IANA 时区名，默认北京时间
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`	输入参数校验

路线图

八字基础排盘与时运列表
紫微基础排盘与时运列表
六爻排盘
梅花易数排盘
大六壬排盘
奇门遁甲排盘
大六壬时间起课（自动推节气/干支）
多时区支持（timezone 参数）
奇门口径修正（拆补符头、地盘布局、转盘星门，参照《神奇之门》与 kinqimen 交叉验证）
排盘完整性对称盘点（八字补纳音/藏干十神/十二长生/命宫胎元，紫微补五行局/命主/身主）
输出契约测试全覆盖 + 权威用例金样本（历史人物记载、立春分钟级边界、iztro 适配保真）

版本历史

版本	说明
0.1.4	正确性修复：八字年柱按立春精确时刻换年（原立春至春节窗口错排，连带月干/大运顺逆）、晚子时时柱按次日干起五鼠遁、奇门四类口径修正（详见 `docs/qimen-correctness-notes.md`）、stdio 日志不再污染 JSON-RPC 流；输出定位确立：只输出确定且权威且 AI 不易获知的排盘量——bazi_basic 为四柱纳音/天干藏干十神/十二长生自坐/命宫胎元/旬空/公农历，紫微补五行局/命主/身主，梅花去断语，奇门格局平列、用神去评分，择日工具（qimen_zeri）移除；新能力：大六壬时间起课、多时区（timezone）；MCP SDK 高级 API 迁移与工具模块化、zod v4、净代码缩减约 15%；测试 117→218
0.1.3	奇门用神分析与择日
0.1.2	六爻、梅花易数、大六壬
0.1.0	首个发布：八字、紫微

许可证

Apache License 2.0