taibu-mcp

taibu-mcp

TaiBu 的本地 stdio MCP Server，适合直接接入 Claude Desktop、Cursor、Cherry Studio 等支持 MCP 的客户端。

快速开始

在 MCP 客户端配置中加入：

{
  "mcpServers": {
    "taibu": {
      "command": "npx",
      "args": ["-y", "taibu-mcp"]
    }
  }
}

要求：

• 本机已安装 Node.js
• 客户端支持 MCP stdio 连接方式

如需从 GitHub Packages 安装镜像包，请改用 @hhszzzz/taibu-mcp，并把 @hhszzzz scope 指向 https://npm.pkg.github.com。npmjs 主包名仍然是 taibu-mcp。

可用工具

工具	说明
bazi	八字排盘
bazi_pillars_resolve	四柱反推
bazi_dayun	大运、小运、流年链路
ziwei	紫微斗数排盘
ziwei_horoscope	紫微运限
ziwei_flying_star	紫微飞星
liuyao	六爻排卦分析
meihua	梅花易数起卦与断卦
tarot	塔罗抽牌
almanac	黄历查询
astrology	西方占星命盘与流运
qimen	奇门遁甲排盘
taiyi	太乙九星观测
daliuren	大六壬排盘
xiaoliuren	小六壬占测

返回结构

本地 taibu-mcp 的工具结果统一分成两条通道：

• content[0].text
  • 始终返回 canonical text，适合人类直接阅读或交给 AI 继续消费
• structuredContent
  • 当工具声明了 outputSchema 时返回 canonical JSON，字段结构与 outputSchema 对齐，适合程序消费

如果你要稳定的结构化结果，请始终读取 structuredContent。

其他安装方式

npm install -g taibu-mcp

全局安装后也可以在 MCP 客户端中改成：

{
  "mcpServers": {
    "taibu": {
      "command": "taibu-mcp"
    }
  }
}

本地开发

pnpm install
pnpm -C packages/core build
pnpm -C packages/mcp build
node packages/mcp/dist/index.js

相关包

• taibu-core: 共享算法、工具定义与 transport 适配器

License

taibu-mcp 使用 MIT 许可证，详见当前目录下的 LICENSE 文件。

版本批次

版本	批次说明
3.4.1	修复 npm 包中 taibu-core 依赖误发为 workspace:*，恢复 npx -y taibu-mcp 可用性
3.4.0	新增 astrology 西方占星命盘与流运
3.3.0	新增 taiyi 太乙九星观测
3.2.0	新增 xiaoliuren 小六壬占测
3.1.0	新增 meihua 梅花易数起卦与断卦
3.0.0	重构包结构，优化输出与函数暴露接口
2.0.0	规范输出结构：content 输出规范文本，structuredContent 输出 JSON
1.5.0	同步导出、共享、结构化输出策略与在线服务对齐
1.4.0	新增 daliuren 大六壬
1.3.0	新增 qimen 奇门遁甲
1.2.6	补丁，集中修复输出契约、鉴权与运行时边界
1.2.5	旧基线版本，作为本次版本重排的对比起点