About
Mingli (命理) is a traditional Chinese astrology and destiny analysis service that generates detailed fortune charts using Ziwei Doushu (紫微斗数) and Bazi (八字/Four Pillars) systems based on birth date, time, and gender. Key features: - Ziwei Doushu chart generation with 12 palaces, main stars, auxiliary stars, and transformation indicators - Bazi/Four Pillars analysis with heavenly stems, earthly branches, Ten Gods, and hidden stems - Fortune predictions across multiple time scales: decades (大限), years (流年), months (流月), days (流日), and hours (流时) - Five Elements (五行) analysis with scoring, balance assessment, and missing element identification - Palace-specific analysis for destiny, career, wealth, relationships, health, and more - True solar time correction supporting 200+ cities worldwide for precise hour determination - Multi-language output: Simplified Chinese, Traditional Chinese, English, Japanese, Korean, and Vietnamese - Multiple calendar support: solar and lunar date inputs - Output formats: JSON and Markdown
Tools 7
get_ziwei_chart获取紫微斗数排盘信息，包含命盘十二宫、主星、辅星、四化等详细信息
get_ziwei_fortune获取紫微斗数运势信息，包含大限、流年、流月、流日、流时的运势详情
analyze_ziwei_palace分析紫微斗数特定宫位的详细信息
list_fortune_systems列出所有可用的命理系统（紫微斗数、八字、占星等）
get_bazi_chart获取八字（四柱）排盘信息，包含年月日时四柱、十神、五行、地支藏干等详细信息
get_bazi_fortune获取八字运势信息，包含大运、流年等详情
analyze_bazi_element分析八字五行强弱，包含五行分数、平衡度、缺失五行等
README
命理MCP服务 (Mingli MCP Server)
一个支持多种命理系统（紫微斗数、八字、占星等）的 Model Context Protocol (MCP) 服务器，专为 AI 工具（如 Cursor IDE）设计。
✨ 特性
🎯 核心特性
🔮 紫微斗数功能
🎴 八字功能 ⭐ 新增
---
📚 文档导航
新用户推荐阅读路径：
1. 快速开始指南 ⭐ - 5分钟快速上手 - 安装方法（uvx、pip、Docker） - IDE配置示例 - 第一次排盘体验
2. 用户指南 - 完整功能说明 - 所有工具详解 - 参数说明 - 输出格式对比 - 使用限制
3. 真太阳时使用指南 ⭐ - 精确时辰修正（新功能） - 200+全球城市支持 - 自动时辰修正 - 适用于西北地区
4. API使用示例 - 17个实用代码示例 - 基础用法 - 紫微斗数、八字示例 - 高级模式（批量处理、错误处理）
5. 故障排查指南 - 16个常见问题解决方案 - 安装问题 - 配置问题 - 运行时错误 - 调试技巧
开发者文档：
---
📋 可用工具
1. get_ziwei_chart
获取紫微斗数完整排盘信息参数:
date (string, 必需): 出生日期 YYYY-MM-DD，如 "2000-08-16"time_index (integer, 必需): 时辰序号 0-12gender (string, 必需): 性别 "男" 或 "女"calendar (string, 可选): 历法 "solar"(阳历) 或 "lunar"(农历), 默认 "solar"is_leap_month (boolean, 可选): 是否闰月，默认 falseformat (string, 可选): 输出格式 "json" 或 "markdown", 默认 "markdown"language (string, 可选): 输出语言，可选 "zh-CN", "zh-TW", "en-US", "ja-JP", "ko-KR", "vi-VN"，默认 "zh-CN" ⭐ 新增示例:
{
"date": "2000-08-16",
"time_index": 2,
"gender": "女",
"calendar": "solar"
}
2. get_ziwei_fortune
获取紫微斗数运势信息参数:
birth_date (string, 必需): 出生日期time_index (integer, 必需): 时辰序号gender (string, 必需): 性别calendar (string, 可选): 历法类型query_date (string, 可选): 查询日期，不填则为今天format (string, 可选): 输出格式language (string, 可选): 输出语言，默认 "zh-CN" ⭐ 新增3. analyze_ziwei_palace
分析紫微斗数特定宫位参数:
birth_date (string, 必需): 出生日期time_index (integer, 必需): 时辰序号gender (string, 必需): 性别palace_name (string, 必需): 宫位名称，可选值：calendar (string, 可选): 历法类型format (string, 可选): 输出格式language (string, 可选): 输出语言，默认 "zh-CN" ⭐ 新增4. list_fortune_systems
列出所有可用的命理系统5. get_bazi_chart ⭐ 新增
获取八字（四柱）排盘信息参数:
date (string, 必需): 出生日期 YYYY-MM-DDtime_index (integer, 必需): 时辰序号 0-12gender (string, 必需): 性别 "男" 或 "女"calendar (string, 可选): 历法 "solar"(阳历) 或 "lunar"(农历), 默认 "solar"is_leap_month (boolean, 可选): 是否闰月，默认 falseformat (string, 可选): 输出格式 "json" 或 "markdown", 默认 "markdown"示例:
{
"date": "2000-08-16",
"time_index": 2,
"gender": "女"
}
输出包含:
6. get_bazi_fortune ⭐ 新增
获取八字运势信息参数:
birth_date (string, 必需): 出生日期time_index (integer, 必需): 时辰序号gender (string, 必需): 性别calendar (string, 可选): 历法类型query_date (string, 可选): 查询日期，不填则为今天format (string, 可选): 输出格式输出包含:
7. analyze_bazi_element ⭐ 新增
分析八字五行强弱参数:
birth_date (string, 必需): 出生日期time_index (integer, 必需): 时辰序号gender (string, 必需): 性别calendar (string, 可选): 历法类型format (string, 可选): 输出格式输出包含:
🚀 快速开始
在线体验
claude mcp add mingli -- uvx mingli-mcpcodex mcp add mingli -- uvx mingli-mcp---
📦 安装方式
方式1: uvx (推荐)
使用 uvx 是最简单的安装方式，无需手动管理依赖：
在 ~/.cursor/mcp.json 或对应IDE的MCP配置文件中添加：
{
"mcpServers": {
"mingli": {
"command": "uvx",
"args": ["mingli-mcp"],
"env": {
"LOG_LEVEL": "INFO"
}
}
}
}
方式2: Docker
使用 Docker 部署，适合服务器环境或需要隔离的场景：
```bash
下载配置文件
mkdir -p /opt/mingli-mcp cd /opt/mingli-mcpRelated MCP Servers
AI Research Assistant
hamid-vakilzadeh
AI Research Assistant provides comprehensive access to millions of academic papers through the Semantic Scholar and arXiv databases. This MCP server enables AI coding assistants to perform intelligent literature searches, citation network analysis, and paper content extraction without requiring an API key. Key features include: - Advanced paper search with multi-filter support by year ranges, citation thresholds, field of study, and publication type - Title matching with confidence scoring for finding specific papers - Batch operations supporting up to 500 papers per request - Citation analysis and network exploration for understanding research relationships - Full-text PDF extraction from arXiv and Wiley open-access content (Wiley TDM token required for institutional access) - Rate limits of 100 requests per 5 minutes with options to request higher limits through Semantic Scholar
Math-MCP
EthanHenrickson
Math-MCP is a computation server that enables Large Language Models (LLMs) to perform accurate numerical calculations through the Model Context Protocol. It provides precise mathematical operations via a simple API to overcome LLM limitations in arithmetic and statistical reasoning. Key features of Math-MCP: - Basic arithmetic operations: addition, subtraction, multiplication, division, modulo, and bulk summation - Statistical analysis functions: mean, median, mode, minimum, and maximum calculations - Rounding utilities: floor, ceiling, and nearest integer rounding - Trigonometric functions: sine, cosine, tangent, and their inverses with degrees and radians conversion support
Saju Insights
hjsh200219
Saju Insights provides personalized Korean traditional Four Pillars of Destiny (Saju) fortune-telling based on birth data. It calculates destiny charts using the eight characters (four heavenly stems and four earthly branches) derived from birth year, month, day, and hour. Key capabilities include: - Birth chart calculation with automatic True Solar Time adjustment (Jintaeyangsi -30min correction) - Fortune analysis covering personality, career, wealth, health, and love prospects - Relationship compatibility analysis comparing two people's Saju charts - 10-year luck cycle (Daewon) predictions for long-term planning - Yongsin (favorable element) guidance on lucky colors, directions, and career paths - Lunar-solar calendar conversion supporting 1900-2200 with leap month handling - Daily fortune readings and seasonal power calculations - Multiple interpretation schools including Ziping, DTS, and modern methodologies