mingli-mcp

一个支持多种命理系统（紫微斗数、八字、占星等）的 Model Context Protocol (MCP) 服务器，专为 AI 工具（如 Cursor IDE）设计。

• ✅ 多命理系统支持: 采用插件化架构，轻松扩展新的命理系统
• ✅ 紫微斗数（已实现）
• ✅ 八字（已实现）⭐ 新增
• 🔄 西方占星（预留接口）
• ✅ 多语言支持: 支持6种语言输出 ⭐ 新增
• 🇨🇳 简体中文 (zh-CN)
• 🇹🇼 繁体中文 (zh-TW)
• 🇺🇸 English (en-US)
• 🇯🇵 日本語 (ja-JP)
• 🇰🇷 한국어 (ko-KR)
• 🇻🇳 Tiếng Việt (vi-VN)
• ✅ 多传输方式: 支持stdio、HTTP、WebSocket等多种传输协议
• ✅ MCP标准兼容: 完全兼容 MCP 协议规范
• ✅ 易于扩展: 清晰的抽象层设计，添加新系统只需3步

• ✅ 完整排盘: 十二宫、主星、辅星、杂耀、四化等
• ✅ 运势查询: 大限、流年、流月、流日、流时
• ✅ 宫位分析: 深度分析特定宫位的星曜配置
• ✅ 多种历法: 支持阳历和农历输入
• ✅ 格式化输出: JSON和Markdown两种输出格式
• ⭐ 真太阳时: 支持全球200+城市的精确时辰修正 新功能

• ✅ 四柱排盘: 年月日时四柱、天干地支详细信息
• ✅ 十神分析: 比肩、劫财、食神、伤官、偏财、正财、七杀、正官、偏印、正印
• ✅ 五行分析: 金木水火土分数、百分比、平衡度
• ✅ 地支藏干: 详细的地支藏干信息
• ✅ 运势查询: 大运、流年分析
• ✅ 缺失分析: 自动识别五行缺失并给出建议
• ✅ 多种历法: 支持阳历和农历输入
• ⭐ 真太阳时: 支持全球200+城市的精确时辰修正 新功能

---

新用户推荐阅读路径：

1. [快速开始指南](docs/QUICK_START.md) ⭐ - 5分钟快速上手

• 安装方法（uvx、pip、Docker）
• IDE配置示例
• 第一次排盘体验

1. [用户指南](docs/USER_GUIDE.md) - 完整功能说明

• 所有工具详解
• 参数说明
• 输出格式对比
• 使用限制

1. [真太阳时使用指南](docs/TRUE_SOLAR_TIME.md) ⭐ - 精确时辰修正（新功能）

• 200+全球城市支持
• 自动时辰修正
• 适用于西北地区

1. [API使用示例](docs/API_EXAMPLES.md) - 17个实用代码示例

• 基础用法
• 紫微斗数、八字示例
• 高级模式（批量处理、错误处理）

1. [故障排查指南](docs/TROUBLESHOOTING.md) - 16个常见问题解决方案

• 安装问题
• 配置问题
• 运行时错误
• 调试技巧

开发者文档：

• [CLAUDE.md](CLAUDE.md) - Claude Code开发指南
• [更多文档](docs/README.md) - 完整文档索引

---

获取紫微斗数完整排盘信息

参数:

• date (string, 必需): 出生日期 YYYY-MM-DD，如 "2000-08-16"
• time_index (integer, 必需): 时辰序号 0-12
• 0=早子时(23-01), 1=丑时(01-03), 2=寅时(03-05), 3=卯时(05-07)
• 4=辰时(07-09), 5=巳时(09-11), 6=午时(11-13), 7=未时(13-15)
• 8=申时(15-17), 9=酉时(17-19), 10=戌时(19-21), 11=亥时(21-23)
• 12=晚子时(23-01)
• gender (string, 必需): 性别 "男" 或 "女"
• calendar (string, 可选):