SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI开发平台bazi-reader-mcp

bazi-reader-mcp

bazi-reader-mcp 是一个开源的中文八字（四柱）计算引擎兼 MCP 服务器，源自顺时（Shunshi.AI）的生产后端。它支持真太阳时（均时差）校正，并默认开启，能根据出生年月日、时刻和出生地计算四柱、十神、大运、五行平衡、刑冲合会、神煞等内容，输出支持中文、英文、日文和韩文，便于不同语种的 AI 助手直接调用。项目以 monorepo 形式发布 shunshi-bazi-core 和 shunshi-bazi-mcp 两个 npm 包，共用同一计算引擎，并在每次发布时进行一致性测试。它解决了多数开源八字库存在的四类问题：未做真太阳时校正、子时处理不一致、缺少与专业工具的对照基准、输出仅限中文且缺乏多语言上下文。用户可将它接入 Claude、Cursor、Cline 等 MCP 客户端，用自然语言提问生成八字盘或黄历信息。项目采用 MIT 许可。

访问官网

工具介绍

bazi-reader-mcp 是一个开源项目，提供中文八字（四柱）排盘的计算引擎以及对应的 MCP 服务器。它由顺时（Shunshi.AI）开源，是其生产后端所用的计算引擎。项目同时面向中文、日文、韩文和英文用户，在日文中对应“四柱推命”，在韩文中对应“사주팔자（四柱八字）”。

用途与定位 该项目主要用于让 AI 智能体具备读取和计算八字盘的能力。它既可以被直接嵌入到开发者自己的应用中作为计算库使用，也可以通过 MCP 协议接入 Claude、Cursor、Cline 等支持 MCP 的客户端，让 AI 助手用自然语言完成排盘或查询黄历。仓库以 monorepo 形式维护两个已发布的 npm 包：shunshi-bazi-core 和 shunshi-bazi-mcp，两者共享同一计算引擎，并在每次发布时进行一致性（parity）测试。

主要能力 根据出生年月日、出生时刻和出生地，计算四柱、十神、大运、五行平衡等内容。项目强调以下特性：

  1. 内置真太阳时校正，默认开启，只需传入城市或经纬度即可，可避免因出生地远离时区标准经线（如新疆、黑龙江、美国西海岸、北海道）导致的排盘错误——30 分钟误差会移动整个时柱。
  2. 默认采用 sect=1，即 23:00 归入次日日柱，与问真八字一致，从而统一子时处理方式。
  3. 具备对照基准：与 Shunshi.AI 的 Python 后端进行一致性测试（5/5 黄金用例通过），并与 cantian-tymext 的 calculateRelation() 在刑冲合会成对子集上 5/5 匹配。
  4. 多语言可发现性：通过关键词（bazi / 八字 / 四柱推命 / 사주팔자 / saju / shichu-suimei）让日、韩、英文开发者都能找到该包。

使用方式 如果要将八字计算嵌入自己的应用，可参考 packages/bazi-core/README.md 中的完整 API 与输出说明。 若希望 Claude / Cursor / Cline 计算八字盘，可将该项目加入 MCP 配置（例如 claude_desktop_config.json），然后重启客户端，并用自然语言向 AI 智能体提问，例如：“帮我算一下 1990 年 3 月 24 日 上午 10 点 28 分出生在广州的男生的八字。” 该服务器暴露两个工具：

  • getBaziChart：完整的八字（四柱）盘，包含真太阳时校正、大运、刑冲合会、神煞。
  • getHuangli：任意日期的黄历（老黄历），包含宜/忌、彭祖百忌、神煞、建除、二十八宿、吉神方位、12 时辰宜忌。接受公历或农历输入；省略日期则默认为今天。 更多 MCP 工具文档、其他客户端配置和故障排除可参考 packages/bazi-mcp/README.md。

仓库结构与测试 packages/bazi-core/tests/parity.test.ts：5 个黄金用例，手工依据问真八字截图标注，并与 Shunshi.AI 的 Python 后端在四柱、十神、空亡、纳音、藏干上交叉核对。 packages/bazi-core/tests/relations-vs-cantian.test.ts：与 cantian-tymext 的 calculateRelation() 在刑冲合会（成对子集：合/冲/刑/害/破/克）上 5/5 匹配。 packages/bazi-mcp/tests/smoke-stdio.ts：端到端 stdio 握手 + tools/list + tools/call，断言真实四柱输出和数据来源归属块。使用真实 MCP SDK 客户端，因此走的是与 Claude Desktop 完全相同的代码路径。

相关项目

  • 6tail 的 tyme4ts：本库构建所依赖的 TypeScript 农历/公历基础组件。
  • cantian-ai/bazi-mcp：开创性的开源八字 MCP。本项目将他们的 cantian-tymext 作为开发依赖，用于关系一致性测试。两个 MCP 是互补而非竞争关系，本项目基于符合中文世界专业实践的默认值（sect=1、默认开启真太阳时）做出了不同选择。

关于项目方 顺时（Shunshi.AI）是一个 AI 驱动的八字解读平台，支持英文、中文、日文和韩文。可免费试用，无需信用卡。项目方开源其生产后端所用的计算引擎，目的是让任何开发者都能以与其付费产品相同的精度计算八字盘，一次性解决真太阳时、子时等边缘情况，并为日、韩、英文开发者提供使用其术语（四柱推命 / 사주팔자）的 TypeScript 库。

许可证 MIT © 2026 Shunshi.AI。

同类工具

查看分类