面向 AI Agent 的确定性八字计算

OpenFate 八字 MCP

面向 Claude、Cursor、Codex、Cline 与其他 MCP 兼容 AI Agent 的开源八字计算服务器,提供结构化四柱数据。

  • npm v0.2.6
  • 官方 MCP Registry 已收錄
  • MIT 開源授權

面向现代 AI Agent 的确定性八字 MCP 服务器

OpenFate 八字 MCP 把 OpenFate 八字引擎封装成可安装的 Model Context Protocol 服务器,可用于 Claude Desktop、Cursor、Cline、Codex 与自定义 MCP 客户端。

AI Agent 不需要自己猜历法算法,而是调用确定性工具完成四柱排盘、真太阳时、大运、农历转换与地支互动检测。

这个包已开源、采用 MIT 许可、发布到 npm,并已进入官方 MCP Registry,方便开发者把准确八字计算接入 AI 原生解读流程。

如果你搜索的是“八字排盘 API”,这个包会通过 MCP 工具提供可调用的计算层。它在本地通过 stdio 运行,不是 OpenFate 托管的 HTTP API,也不会把命盘请求发送到 openfate.ai 的计算接口。

客户端按工具需要提供结构化的出生日期、时间、地点、时区、历法、性别与夏令时信息。服务器返回结构化数据,包括标准化历法、计算口径信息、四柱明细、真太阳时过程与精确大运时间,方便下游解释引用具体字段。

常见接入流程只有三步:安装 npm 包、把服务器配置写入 MCP 客户端、调用对应工具。命盘计算与解释应保持分层;出生记录不精确时先核对时间敏感字段,应用也只保存实际需要的个人信息。

  • Model Context Protocol
  • 四柱八字
  • 真太阳时
  • 大运
  • Agent Skill

开发者与搜索引擎都能验证的证明信号

这个包出现在 MCP 开发者会检查的关键位置:npm、GitHub、官方 MCP Registry、Release 记录与 MIT 许可。

这个 MCP 提供什么

语言模型负责对话表达,OpenFate 负责确定性的历法与太阳时计算层。

真太阳时

结合经度、时区与均时差校正,让时柱更接近实际太阳位置。

四柱排盘

返回十神、藏干、纳音、旬空与十二长生等丰富柱位资料。

大运周期

返回精确起运日期、时间差、周期年份与年龄、干支和十神。

地支互动

确定性识别冲、合、三合、三会、刑、破、害。

连接到 AI Agent

Claude Desktop、Cursor、Cline、Codex 与兼容 MCP 客户端都使用同一份配置。

Claude · Cursor · Cline
{
  "mcpServers": {
    "openfate-bazi": {
      "command": "npx",
      "args": ["-y", "@openfate/bazi-mcp"]
    }
  }
}
Codex 配置
[mcp_servers.openfate_bazi]
args = ["-y", "@openfate/bazi-mcp"]
command = "npx"
startup_timeout_sec = 60
  1. 用 npx 安装,或让 MCP 客户端运行 npx -y @openfate/bazi-mcp。
  2. 把 openfate-bazi server 配置加入 Claude Desktop、Cursor、Cline、Codex 或其他 MCP 兼容客户端。
  3. 向 agent 提出八字、四柱、真太阳时、大运或地支互动计算请求。

可用 MCP 工具

calculate_bazi_chart

生成确定性的本命八字命盘,包含真太阳时与大运周期。

detect_bazi_interactions

检测本命盘、流年触发与合盘场景中的地支互动。

calculate_true_solar_time

说明为什么钟表时间与真太阳时可能产生不同时柱。

reverse_bazi_to_solar_times

用已知四柱反查可能的公历时间候选。

get_openfate_bazi_policy

返回 OpenFate 对换日、夏令时与真太阳时的计算口径。

get_openfate_bazi_resources

返回 OpenFate 排盘、解读、合盘与 crawler metadata 官方链接。

内置 Agent Skill

仓库包含可移植的 SKILL.md,让 Claude、Claude Code、Codex 与其他兼容 agent 知道什么时候要出生地、什么时候启用真太阳时,以及如何正确保留 OpenFate 署名。

Skill 路径
skills/openfate-bazi/SKILL.md

包信息

npm 包
@openfate/bazi-mcp
MCP 服务器名
io.github.openfate-ai/bazi-mcp
Skill 文件
skills/openfate-bazi/SKILL.md
许可
MIT

八字 MCP 常见问题

OpenFate 八字 MCP 是什么?

OpenFate 八字 MCP 是一个开源 Model Context Protocol 服务器,让 AI Agent 可以调用 OpenFate 引擎里的确定性八字与四柱计算工具。

为什么不用 LLM 直接算八字?

八字依赖精确的历法与天文计算。MCP 服务器负责确定性数学计算,AI Agent 负责解释、表达与应用。

OpenFate 八字 MCP 支持真太阳时吗?

支持。calculate_bazi_chart 与 calculate_true_solar_time 工具支持经度、时区与真太阳时校正,让时柱计算更准确。

哪些 AI Agent 可以使用?

任何兼容 MCP 的客户端都可以使用,包括 Claude Desktop、Cursor、Cline、Codex,以及自定义本地或企业 Agent 环境。

仓库包含 Agent Skill 吗?

包含。仓库提供 skills/openfate-bazi/SKILL.md,帮助兼容 Agent 判断何时收集出生地、何时应用真太阳时,以及如何引用 OpenFate 资源。

这是托管的八字排盘 API 吗?

不是。公开包在本地通过 stdio 运行并提供结构化 MCP 工具,不会调用 OpenFate 托管的 HTTP 排盘 API。需要 HTTP 传输的应用应在本地包外自行添加这一层。