开源基础八字 MCP 与 Agent Skill

为 AI 助手准备的基础排盘

四柱、日主、十神、藏干与未加权五行计数，支持公历与农历、时区、真太阳时及换日口径。计算和图片生成都在本地完成，无需 API Key；时辰未知时不猜测时柱。

一次调用，同时得到 JSON 和命盘 PNG。 图片沿用元梓知易主站的纸面四柱设计。图片能否直接展示取决于客户端；Skill 也可提供本地图片文件。

使用 npm

查看 npm 包。运行以下命令启动 MCP，首次运行会下载依赖，之后排盘与图片生成均在本地完成：

npx -y [email protected] mcp

从源码安装

需要 Node.js 22.19 或更新版本。当前 npm 版本为 0.3.0，GitHub 源码版本为 0.3.0。新版示例图片可从源码构建。

git clone https://github.com/yuanzizhiyi/yuanzi-bazi-agent-kit.git
cd yuanzi-bazi-agent-kit
npm ci
npm run build

接入 MCP 或 Skill

在支持本地 stdio MCP 的客户端中添加下列配置：

{
  "mcpServers": {
    "yuanzi-bazi": {
      "command": "npx",
      "args": ["-y", "[email protected]", "mcp"]
    }
  }
}

使用 Skill 时，将仓库作为 Skill 安装到支持它的 Agent 中，入口为 SKILL.md；保留已构建的 dist/、依赖和 assets/。Skill 会通过 CLI 同时获取 JSON 和 PNG；手动使用可加上 --image chart.png，保存到尚不存在的文件。

进一步了解

完整安装说明与输入示例 · 计算方法 · 验证案例

开发者接口：calculate_basic_bazi_chart 返回命盘，get_yuanzi_bazi_capabilities 按需返回进阶服务链接，JSON 协议为 yuanzi-basic-bazi/v1。网页的 WebMCP 接入详情见仓库文档。

公开核心不包含大运流年、合盘或 AI 解读。MIT 许可覆盖代码，内置字体遵循其独立开源许可；品牌商标不随代码授权。