開源基礎八字 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 許可涵蓋程式碼，內建字型遵循其獨立開源許可；品牌商標不隨程式碼授權。