觉山排盘 MCP · 八字 / 紫微斗数 / 奇门遁甲

三套中国命理排盘，做成一个 MCP 服务。按真实历法计算，避免模型自行计算出错；出生地自动做真太阳时修正，给 AI 一份能直接用的命盘。

为什么做这个

拿市面上的 AI 算命工具试过几次之后，发现排盘经常是错的。有的时辰算错，有的直接忽略真太阳时，有的把阳历当阴历。命盘错了，后面分析得再漂亮，都建立在沙子上面。

命理这事，排盘是硬功夫。四柱、星盘、九宫，都有明确的算法规则，应该交给程序算，而不是让大模型"凭感觉写一个"。所以我们把八字、紫微斗数、奇门遁甲三套排盘整理成一个 MCP 服务——算法负责准确，AI 负责解读。算错一步都算我们输。

Related MCP server: Chinese Fortune Analysis System (BaZi)

它能做什么

几个值得一提的点：

• 真太阳时修正。出生在乌鲁木齐和杭州，同一钟点，时辰可能差一个。传城市名或经度，引擎自动按 NOAA 均时差公式修正。

• 输出是结构化的。JSON 给程序用，Markdown 给聊天直接展示。

• 三套体系共用一个服务。

装一下就能用

pip install jueshan-paipan-mcp
# 或者从源码装
pip install -e .

Claude Desktop / Cursor / VS Code

在 MCP 配置里加：

{
  "mcpServers": {
    "paipan": {
      "command": "python",
      "args": ["-m", "jueshan_paipan_mcp.server"]
    }
  }
}

命令行直接起服务

python -m jueshan_paipan_mcp.server

用法示例

跟 AI 说这些话就行：

帮我排个八字盘：1990 年 6 月 15 日中午 12 点，男，出生在杭州。 用紫微斗数看看他事业怎么样。 这个时间起个奇门局，看看最近事态。

calc_bazi 参数

calc_ziwei、calc_qimen、paipan 参数一致，paipan 额外有 system 参数（'auto' / 'bazi' / 'ziwei' / 'qimen'）。

排出来长这样

calc_bazi(1990, 6, 15, 12, 0, "男", city="杭州")：

## 八字命盘

- 公历：1990年6月15日　农历：一九九〇年五月廿三　午时　男命
- 日主：辛（金）

| 柱 | 天干 | 地支 | 十神 | 纳音 |
|----|------|------|------|------|
| 年柱 | 庚 | 午 | 劫财 | 路旁土 |
| 月柱 | 壬 | 午 | 伤官 | 杨柳木 |
| 日柱 | 辛 | 亥 | 日主 | 钗钏金 |
| 时柱 | 甲 | 午 | 正财 | 沙中金 |

**大运：** 癸未（7-16岁） → 甲申（17-26岁） → 乙酉（27-36岁） → 丙戌（37-46岁） → 丁亥（47-56岁） → 戊子（57-66岁） → 己丑（67-76岁） → 庚寅（77-86岁） → 辛卯（87-96岁）

**神煞：** 天乙贵人（年支午）、天乙贵人（月支午）、天乙贵人（时支午）、将星（年支午）……

calc_ziwei(...) 同样返回十二宫 Markdown 表格。具体效果可以装起来跑一次，比截图直观。

原理

• 八字：四柱、纳音、大运、神煞推算，历法数据来自 lunar-python

• 紫微斗数：安星法 + 生年四化 + 大限 + 飞星，星曜排布来自 purplestar

• 奇门遁甲：时家奇门拆补法，节气定局、三元、地盘/天盘/人盘/神盘

• 真太阳时：NOAA 均时差公式，按出生地经度把钟表时间校正为当地太阳时

排盘是确定性计算，不依赖任何模型。同一份出生信息，算一百次结果都一样，可以复核。

关于

这个项目来自 觉山灵机易理——一个把八字、紫微、奇门和 AI 深度分析放在一起的命理平台。

这里开源的是排盘引擎部分（公共命理算法）。平台的 AI 分析思路和私有知识库不在这里。

如果你想要的不只是排盘，还想让 AI 帮你逐宫解读性格、事业、婚姻、流年大运，可以到 jueshanyili.com 看看。也欢迎在这里提 issue、交流排盘细节，或邮件联系：dev@jueshanyili.com

English

Jueshan Paipan MCP — a Model Context Protocol server that does BaZi (Chinese Four Pillars), Zi Wei Dou Shu (Purple Star Astrology), and Qi Men Dun Jia chart calculation.

The three charting systems are computed with real calendrical algorithms, not LLM guessing. Birth place can be passed as a city name or longitude; the server applies true solar time correction automatically, which many fortune-telling tools skip.

Tools: calc_bazi, calc_ziwei, calc_qimen, paipan. Each returns structured JSON plus a Markdown chart ready to display in a chat.

Install:

pip install jueshan-paipan-mcp

Add to your MCP client config:

{
  "mcpServers": {
    "paipan": {
      "command": "python",
      "args": ["-m", "jueshan_paipan_mcp.server"]
    }
  }
}

Then ask your AI: "Calculate the BaZi chart for 1990-06-15 12:00, male, born in Hangzhou."

Algorithms: lunar-python (BaZi), purplestar (Zi Wei), custom Qi Men with solar-term-based Ju setting. MIT licensed.

This project originates from Jueshan Lingji Yili, a Chinese metaphysics platform combining these three systems with AI deep analysis. Only the chart-calculation engines are open-sourced here.