觉山排盘 MCP · Jueshan Paipan MCP

八字 · 紫微斗数 · 奇门遁甲 —— 三体系合一的排盘 MCP Server

为 AI 智能体提供精确的中国传统命理排盘数据。基于真实历法算法计算，支持真太阳时自动修正，输出结构化 JSON 与 Markdown 盘面，让任何 AI 都能"看得懂、排得准"。

🔮 深度 AI 命理分析（性格 / 事业 / 婚姻 / 流年）→ 觉山灵机易理

✨ 亮点

• 三体系合一：一个 MCP 服务覆盖八字、紫微斗数、奇门遁甲，市面罕见

• 精准排盘：真实历法算法（lunar-python / purplestar），非 AI 估算

• 真太阳时修正：输入出生地（城市或经度）自动修正时辰，多数排盘工具没有

• 双输出格式：结构化 JSON（机器可读）+ Markdown 盘面（聊天可直接展示）

• 易于集成：兼容 Claude Desktop、Cursor、VS Code、n8n 等所有 MCP 客户端

Related MCP server: Chinese Fortune Analysis System (BaZi)

⚙️ 提供的工具

📦 安装

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

🚀 快速开始

方式一：Claude Desktop / Cursor / VS Code

在 MCP 客户端配置中添加：

{
  "mcpServers": {
    "paipan": {
      "command": "uv",
      "args": ["--directory", "你的项目路径", "run", "paipan-mcp"]
    }
  }
}

或通过 Python：

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

方式二：命令行直接调用

python -m jueshan_paipan_mcp.server

💬 用法示例（对 AI 说）

帮我排一个八字盘，1990年6月15日中午12点，男，出生在杭州。

再用紫微斗数看看他的事业格局。

这个时间起一个奇门遁甲局，看看最近运势。

AI 会调用对应工具，返回：

{
  "gans": ["庚", "壬", "辛", "甲"],
  "zhis": ["午", "午", "亥", "午"],
  "day_master": "辛",
  "dayun": [...],
  "markdown": "## 八字命盘 ..."
}

🧠 原理

• 八字：四柱推算、十神、纳音、大运、神煞（基于 lunar-python）

• 紫微斗数：安星法 + 四化 + 大限 + 飞星（基于 purplestar）

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

• 真太阳时：NOAA 均时差公式，按出生地经度修正

排盘是确定性计算（公共命理规则），不依赖 AI 模型——保证每次结果一致、精确可复核。

📄 许可证

MIT

🏮 关于 · About

本项目源自 觉山灵机易理 —— 一个融合八字、紫微斗数、奇门遁甲与 AI 深度分析的中国传统文化智能分析平台。

本仓库只开源排盘引擎（公开命理算法），不含平台的 AI 分析逻辑与私有知识库。

需要深入的 AI 命理解读（性格、事业、婚姻、财运、流年大运）？访问 jueshanyili.com 体验完整平台。

我们欢迎命理爱好者与 AI 开发者共同贡献、交流，一起推动中国传统命理文化在 AI 时代的传承与创新。