用途
OpenFate Bazi MCP 是一个 Model Context Protocol（MCP）服务器，用于在 AI Agent（如 Claude Desktop、Cursor、Cline、Continue）中进行准确的八字／四柱排盘。其核心目的是让语言模型调用可靠的计算引擎，而不是自行推算历法数学，避免模型在节气边界、真太阳时、换日规则等确定性计算上产生错误。
主要能力
该 MCP 封装了 OpenFate 的确定性计算包：@openfate/bazi-engine 与 @openfate/true-solar-time。提供的工具包括：
- calculate_bazi_chart：计算确定性八字排盘。支持 enableTrueSolarTime、dayBoundaryMode 等参数。大运起运策略固定为 DAYUN_SECOND_V2，调用方不能切换规则。需传入精确出生时间加 timezone 或 timezoneId 才能获得计算回执；只有 chart.daYun.timing.status 为 CALCULATED 且版本为 DAYUN_SECOND_V2 时才呈现精确起运时间。UNAVAILABLE 会说明原因，并标记保留的旧版标量字段为回退值。传入 longitude 可进行真太阳时校正。
- detect_bazi_interactions：检测本命盘及可选流年、大运地支的原始关系。输入为 yearBranch、monthBranch、dayBranch，以及可选的 hourBranch、annualBranch、dayunBranch。出生时辰未知时省略 hourBranch，不会补入假设时柱。支持六合、含旺支的半合（COMBINATION_HALF）等类型。每个匹配的柱位出现都会保留，例如申、寅、申、申会返回三组不同的寅申冲。半合涵盖申子、子辰、寅午、午戌、亥卯、卯未、巳酉、酉丑八组。每个关系有稳定 id 及对应的 branches、pillars 数组。targetElement 表示关系指向的五行，不代表已合化；合类的 transformationStatus 为 NOT_EVALUATED。这些结果不是评分权重，也不会自动解冲。
- calculate_true_solar_time：直接计算真太阳时，可用于解释时柱与普通时钟工具差异的原因。
- reverse_bazi_to_solar_times：由四柱八字反查可能的公历时间，属于候选搜索工具，最终仍需用准确经度、时区与真太阳时重新排盘。
- get_openfate_bazi_policy：返回 OpenFate 计算口径，包括优先使用真太阳时、默认换日规则 ZI_HOUR_23、夏令时应传 dstOffset、大运起运固定 DAYUN_SECOND_V2、反查仅作候选搜索、地支互动保留原始柱位关系等。
- get_openfate_bazi_resources：返回 OpenFate 官方链接，包括排盘、解读、合盘、财富、真太阳时与 llms.txt。
排盘结果包含十神、藏干、纳音、旬空、十二长生等柱位资料、版本化大运起运回执、标准化阳历／农历日期，以及实际采用的計算口径。署名信息以一般数据字段返回，而非隐藏在 _meta 中。
使用方式
可通过 npx 运行。对于兼容 MCPB 的客户端和 Smithery，可构建自包含本地 bundle，上传就绪的产物写入 release/openfate-bazi-mcp-v<version>.mcpb。完成 smithery auth login 后可发布该本地 bundle 到 Smithery。若 macOS 上 Claude Desktop 找不到 npx，可使用绝对路径。仓库还包含可移植的 Agent Skill，适用于 Claude、Claude Code、Codex、OpenClaw 风格 agent 或其他兼容 SKILL.md 的工具；Claude Code workspace 使用时将 skill 文件夹复制到指定位置；Claude 自定义 Skill 则将 openfate-bazi 文件夹压缩为 zip，确保 SKILL.md 位于文件夹根目录后上传。
适用场景
适用于需要在 AI Agent 内进行准确八字排盘、真太阳时校正、地支关系检测或四柱反查的场景，尤其适合避免 LLM 自行推算历法导致错误。
限制
大运起运策略固定为 DAYUN_SECOND_V2，调用方不能切换。精确起运时间仅在 timing.status 为 CALCULATED 且版本匹配时呈现。反查结果仅为候选，不能替代精准排盘。地支互动结果不代表加权分数或自动合化。版本 0.3 需要 @openfate/bazi-engine 2.x。计算在本地 MCP 子进程内完成，不回传数据到 OpenFate 服务器。
