← 返回目录

Bazi MCP

社区

精准的八字排盘 MCP 服务器，为 AI 智能体提供可靠的数据支持。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 51 / 230
Stars: ★ 436 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js 22+
凭据: 无需凭据
许可证: ISC
最近提交: 12 个月前 ⚠
工具数: 3

63FMRS · C

Bazi MCP 是一个专注于八字排盘的开源 MCP 服务器，提供精准的八字计算工具，适合开发者和玄学爱好者集成到 AI 应用中。

最强项 · 文档质量 16/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

12/20

维护活跃度

14/20

文档质量

16/20

安装易用性

13/20

查看各项评分依据

可靠性 8/20: 静态审查显示服务器包装了可靠的八字计算库（如lunar-javascript），工具定义与README示例一致，但未发现测试或CI工作流，无法验证实际行为，因此可靠性得分不超过12。
安全与权限 12/20: 服务器无外部网络调用，所有计算在本地进行，无凭证处理。输入由MCP框架处理，但未明确显示输入验证或资源限制，存在潜在拒绝服务风险，但未发现重大红线问题。
维护活跃度 14/20: 项目有MIT许可证，近期的提交和版本发布，维护活跃。但未显示依赖更新策略或安全响应渠道，因此得分适中。
文档质量 16/20: README提供详细的工具参数和示例，包含中文和英文支持，但缺少故障排除和限制说明，因此未给满分。
安装易用性 13/20: 提供通过npx和Smithery的简单安装说明，支持stdio和HTTP传输，但未提供客户端配置文件示例（如Claude Desktop的具体配置），且缺少运行时版本兼容性说明，因此得分略低。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

适合谁

需要精准八字排盘数据的 AI 应用开发者
玄学爱好者或命理研究者，希望使用 AI 工具进行排盘分析
希望在 AI 助手（如 Claude Desktop）中集成八字和日历功能的用户

不适合谁

对八字准确性要求不高，或仅需简单娱乐功能的用户
非技术人员，因为没有提供图形界面，需要命令行操作
需要使用商业支持或官方保障的用户（该项目为开源社区驱动）

所需权限

需要 Node.js 运行时环境
需要网络连接（用于通过 npx 安装或与 AI 客户端通信）
无需额外的系统权限，但需确保 AI 客户端能访问本机或通过 HTTP 连接

风险与副作用

八字计算基于传统玄学，结果仅供参考，不应作为决策依据
数据可能存在误差，尽管项目旨在提高准确性，但仍有不确定性
开源项目可能更新频繁或维护不稳定，使用时需关注版本变化
涉及命理内容可能引发争议，需理性看待

安装接入

准备工作

运行环境：Node.js 22+

安装前需确保 Node.js 22 或以上版本。使用 Streamable HTTP 启动：运行 npm start。使用 Stdio 启动：在 AI 应用（如 Claude Desktop）中配置 mcpServers，示例：{"mcpServers":{"Bazi":{"command":"npx","args":["bazi-mcp"]}}}。也可以通过 Smithery 自动安装：npx -y @smithery/cli install @cantian-ai/bazi-mcp --client claude。具体安装步骤请参考项目 README。

claude_desktop_config.json

{
  "mcpServers": {
    "Bazi": {
      "command": "npx",
      "args": [
        "bazi-mcp"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "Bazi": {
      "command": "npx",
      "args": [
        "bazi-mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add Bazi -- npx bazi-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端配置 npx bazi-mcp 并重启后，工具列表中应出现 getBaziDetail、getSolarTimes、getChineseCalendar 三个工具；调用 getBaziDetail 传入 2000-05-15T12:00:00+08:00 应返回包含四柱"戊寅己未己卯辛未"格式的八字结果，即说明连接成功。

常见排障

确保 Node.js 版本为 22 或以上，否则可能无法运行
使用 npx 安装时，若网络受限，请检查网络连接或使用代理
如果使用 Stdio 方式在 Claude Desktop 中无法启动，请检查配置路径和命令是否正确
若 getBaziDetail 返回结果不符合预期，检查输入的日期格式是否规范（例如 ISO 格式）
查看项目 GitHub 仓库的 issue 或社区讨论获取更多帮助

试试这样问

连接成功后，可以直接对 AI 助手这样说：

帮我排一下 2000年5月15日 12点（阳历，北京时间）的八字，要求详细解析十神和神煞。
根据农历 2000-05-15 12:00:00 计算这个女命（性别 0）的八字四柱和大运。
已知八字为戊寅己未己卯辛未，帮我反推出所有可能的公历时间。
查一下 2025年5月7日的黄历，包括宜忌、吉神方位和冲煞。

工具能力 3

getBaziDetail 只读

根据公历或农历时间计算八字排盘详情，包括四柱、十神、神煞等。

getSolarTimes 只读

根据给定的八字返回可能的公历时间列表。

getChineseCalendar 只读

获取指定公历时间（默认今天）的黄历信息。

使用场景

为 AI 智能体提供八字排盘能力，用于性格分析、命运预测等应用。

根据八字反推历史可能的出生时间，辅助命理研究。

获取每日黄历信息，用于择日、出行参考。

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

Bazi MCP 是参天 AI 推出的首个面向玄学领域的 MCP 服务器，旨在解决 GPT 和 DeepSeek 等算命工具经常出现的排盘错误，提供精准的八字数据，可用于性格分析、命运预测等应用。它提供多种工具，包括获取八字详情、根据八字反推可能的公历时间以及获取黄历信息。项目源自 GPT Store 热门应用 _Chinese Bazi Fortune Teller_，现已融入参天 AI 平台，欢迎命理爱好者与 AI 开发者共同参与社区建设。