Mingli MCP Server

# 八字系统实现总结 ## 📅 实现日期 2025-10-27 ## ✅ 实现内容 ### 1. 核心功能 #### 🎴 八字排盘 (BaziSystem) - ✅ 基于 `lunar_python` 库实现阳历/农历转换 - ✅ 自动计算年月日时四柱天干地支 - ✅ 十神分析（比肩、劫财、食神、伤官、偏财、正财、七杀、正官、偏印、正印） - ✅ 五行分析（金木水火土分数统计） - ✅ 地支藏干详细信息 - ✅ 支持阳历和农历输入 - ✅ 闰月处理 #### 📊 运势查询 - ✅ 大运计算（每10年一个大运，简化版） - ✅ 流年分析（当前年份的天干地支、生肖） - ✅ 年龄计算 #### 🌟 五行分析 - ✅ 五行分数统计 - ✅ 五行百分比计算 - ✅ 最旺/最弱五行识别 - ✅ 缺失五行识别 - ✅ 平衡度评价 - ✅ 补救建议 ### 2. 技术架构 #### 📁 文件结构 ``` systems/bazi/ ├── __init__.py # 模块导出 ├── bazi_system.py # 核心系统类（380行） ├── formatter.py # 格式化器（200行） └── lib/ # 参考库（预留） ├── __init__.py ├── bazi.py # 来自 china-testing/bazi ├── common.py ├── convert.py ├── datas.py └── ganzhi.py ``` #### 🔧 核心类 - **BaziSystem**: 继承自 `BaseFortuneSystem`，实现： - `get_chart()`: 排盘 - `get_fortune()`: 运势 - `analyze_element()`: 五行分析 - `analyze_palace()`: 抛出 NotImplementedError（八字无宫位概念） - **BaziFormatter**: 格式化输出 - `format_chart()`: 排盘格式化 - `format_fortune()`: 运势格式化 - `format_element_analysis()`: 五行分析格式化 ### 3. MCP工具集成 #### ✅ 新增的3个MCP工具 1. **get_bazi_chart**: 获取八字排盘 2. **get_bazi_fortune**: 获取运势信息 3. **analyze_bazi_element**: 分析五行强弱 #### 📝 工具参数 所有工具支持： - `date`: 出生日期（YYYY-MM-DD） - `time_index`: 时辰序号（0-12） - `gender`: 性别（男/女） - `calendar`: 历法类型（solar/lunar） - `is_leap_month`: 是否闰月 - `format`: 输出格式（json/markdown） ### 4. 依赖库 #### 新增依赖 ```txt lunar_python>=1.4.7 # 农历转换和四柱计算 bidict>=0.23.0 # 双向字典（参考库使用） colorama>=0.4.6 # 终端颜色（参考库使用） ``` ### 5. 测试覆盖 #### ✅ 测试用例（tests/test_bazi.py） 1. ✅ `test_bazi_chart()` - 排盘测试 2. ✅ `test_bazi_fortune()` - 运势测试 3. ✅ `test_element_analysis()` - 五行分析测试 4. ✅ `test_lunar_calendar()` - 农历测试 #### 测试结果 ``` 通过: 4/4 🎉 所有测试通过！ ``` ## 📊 实现数据 ### 代码统计 - **核心代码**: 约580行 - **测试代码**: 约220行 - **文档更新**: 约70行 - **总计**: 约870行 ### 功能对比 | 功能 | 紫微斗数 | 八字 | |------|---------|------| | 排盘 | ✅ | ✅ | | 运势查询 | ✅ | ✅ | | 宫位分析 | ✅ | ❌ | | 十神分析 | ❌ | ✅ | | 五行分析 | ❌ | ✅ | | 农历支持 | ✅ | ✅ | ## 🎯 实现示例 ### 排盘示例 ```python from systems import get_system system = get_system('bazi') chart = system.get_chart({ 'date': '2000-08-16', 'time_index': 2, 'gender': '女', 'calendar': 'solar' }) print(chart['eight_char']) # 输出: 庚辰 甲申 丙午 庚寅 ``` ### 输出示例 ``` 八字: 庚辰 甲申 丙午 庚寅 日主: 丙 (火) 生肖: 龙 五行分数: 金: 3个 (37.5%) 木: 2个 (25.0%) 水: 0个 (0.0%) 火: 2个 (25.0%) 土: 1个 (12.5%) 缺失五行: 水 平衡度: 五行较平衡 ``` ## 🔄 与参考库的关系 ### china-testing/bazi - **用途**: 参考实现和数据结构 - **集成方式**: 下载源码放在 `lib/` 目录（预留） - **实际使用**: 自行实现，使用 `lunar_python` 作为基础库 ### 优势 - ✅ 更简洁的API设计 - ✅ 统一的接口规范 - ✅ 更好的错误处理 - ✅ MCP协议集成 - ✅ 多格式输出 ## 📈 性能指标 ### 响应时间（估算） - 排盘: ~50ms - 运势查询: ~80ms - 五行分析: ~100ms ### 资源占用 - 内存: 约30MB（加载后） - CPU: 极低（计算简单） ## 🚀 后续优化方向 ### 短期（1-2周） - [ ] 完善大运计算算法（起运岁数、节气影响） - [ ] 添加神煞计算（天乙贵人、桃花等） - [ ] 改进十神分析（加入更多解读） - [ ] 添加格局判断（正格、从格等） ### 中期（1-2月） - [ ] 地支关系分析（六合、三合、六冲、刑害） - [ ] 天干关系分析（合化、相冲） - [ ] 纳音五行 - [ ] 神煞详解 ### 长期（3-6月） - [ ] AI解读功能（基于GPT的命理解读） - [ ] 流月、流日详细计算 - [ ] 合婚功能 - [ ] 改名建议 ## 🎓 技术亮点 ### 1. 插件化架构 - 继承 `BaseFortuneSystem` 抽象基类 - 自动注册到系统中心 - 独立的格式化器 ### 2. 统一接口 - 与紫微斗数保持一致的参数结构 - 统一的错误处理 - 统一的日期格式 ### 3. 可扩展性 - 预留了参考库接口 - 模块化设计便于功能扩展 - 清晰的代码结构 ## 📚 参考资料 ### 使用的库 - [lunar_python](https://github.com/6tail/lunar-python) - 农历和八字计算 - [china-testing/bazi](https://github.com/china-testing/bazi) - 参考实现 ### 命理知识 - 《渊海子平》 - 《三命通会》 - 《滴天髓》 - 《穷通宝鉴》 ## 🙏 致谢 - **lunar_python**: 提供优秀的农历和四柱计算库 - **china-testing/bazi**: 提供完整的八字排盘参考实现 - **项目架构**: 基于紫微系统的优秀架构设计 ## 📝 版本信息 - **实现版本**: 1.0.0 - **实现日期**: 2025-10-27 - **状态**: ✅ 生产就绪 - **测试状态**: ✅ 全部通过 --- **实现者**: Factory AI Assistant **项目**: ziwei_mcp **系统**: BaziSystem (八字四柱命理)