bazi-mcp：AI驱动的精准八字排盘工具

项目介绍

bazi-mcp是由参天AI团队开发的首个面向传统文化领域的AI赋能八字计算工具。作为中国传统命理学与现代人工智能技术的完美结合，该项目针对当前主流AI算命工具（如GPT、DeepSeek等）常见的排盘错误问题，提供了专业级精准的八字数据计算服务。

该项目源自GPT Store热门应用《Chinese Bazi Fortune Teller》，现已成为一个独立的开源项目，为开发者、文化爱好者和AI应用提供可靠的八字数据支持。bazi-mcp不仅能够进行传统八字排盘，还能为AI Agent提供结构化命理数据，实现更智能的分析与预测功能。

项目技术分析

bazi-mcp基于Node.js 22+环境开发，采用现代JavaScript技术栈构建，具有以下核心技术特点：

1. 精准算法核心：项目实现了传统八字计算的所有核心算法，包括：

   • 干支纪年转换算法
   • 真太阳时计算
   • 早晚子时处理（支持两种流派配置）
   • 大运排法计算
   • 神煞系统判定

2. 结构化数据输出：计算结果采用JSON格式，包含：

   • 完整四柱信息（年柱、月柱、日柱、时柱）
   • 详细天干地支属性（五行、阴阳、十神等）
   • 藏干分析（主气、中气、余气）
   • 大运走势（起运时间、各运详情）
   • 刑冲合会关系

3. 多时间系统支持：

   • 公历时间输入（ISO 8601标准格式）
   • 农历时间输入（传统农历格式）
   • 黄历查询功能

4. AI集成友好：提供标准化接口，便于AI Agent调用：

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

项目及技术应用场景

bazi-mcp可广泛应用于以下场景：

1. AI文化应用增强：

   • 为聊天机器人提供专业八字数据支持
   • 提升AI分析结果的准确性和专业性
   • 解决通用大模型在特定领域的"幻觉"问题

2. 文化研究工具：

   • 传统文化研究者专业工具
   • 八字教学辅助系统
   • 算法验证平台

3. 传统文化应用：

   • 黄历查询系统
   • 生肖分析
   • 传统节日计算

4. 个人发展咨询：

   • 性格分析系统
   • 职业发展建议
   • 趋势预测

项目特点

bazi-mcp相较于其他同类工具具有以下显著优势：

1. 专业级精准度：

   • 严格遵循传统计算规则
   • 处理了23:00-23:59早晚子时争议问题
   • 提供真太阳时校正

2. 全面数据维度：

   • 不仅输出基本八字，还包含：
     • 纳音五行
     • 神煞系统（天乙贵人、太极贵人等）
     • 星运状态（长生、冠带、病等）
     • 刑冲合会关系

3. 开发者友好：

   • 简单安装（通过npm或npx）
   • 清晰文档和示例
   • 标准化JSON接口

4. AI集成便捷：

   • 专为AI Agent设计的数据结构
   • 支持通过Smithery平台快速部署：

     npx -y @smithery/cli install @cantian-ai/bazi-mcp --client claude
     

5. 开源社区驱动：

   • 持续优化算法
   • 欢迎专家贡献专业知识
   • 鼓励开发者扩展功能

bazi-mcp代表了传统文化与现代AI技术的创新结合，为八字排盘提供了前所未有的准确性和便捷性。无论是个人文化爱好者、专业研究者，还是AI应用开发者，都能从这个项目中获得价值。项目的开源特性也保证了其可持续发展和不断优化，有望成为特定计算领域的标准工具。

通过bazi-mcp，用户可以轻松获取专业级的分析数据，而开发者则可以快速构建基于传统文化的智能应用，推动中国传统文化在数字时代的传承与创新。