XiaoLiuRenMCP - 小六壬占卜 MCP 服务器
基于 MCP (Model Context Protocol) 的小六壬占卜系统，使用 FastMCP 框架实现，提供完整的中国传统占卜功能。
特性
- 三种输入方式: 数字、汉字、日期
- 四维分析系统: 五行流转、吉凶组合、阴阳平衡、发展趋势
- 智能规则引擎: 90+ 特殊规则 + 动态引擎，覆盖 729 种组合
- MCP 协议: 完全符合 Claude Code 标准
- 通俗化表达: 自动转换专业术语为易懂语言
- 农历支持: 公历/农历自动转换
安装
前置要求
- Python 3.13+
- uv (推荐) 或 pip
快速开始
# 克隆仓库
git clone https://github.com/aicoder2048/xiaoliuren_mcp.git
cd xiaoliuren_mcp
# 使用 uv 安装依赖
uv sync
# 或使用 pip
pip install -e .运行服务器
# 使用 uv
uv run python main.py
# 或直接运行
python main.py核心功能
MCP Tools
1. three_passes - 三传预测
通过三个数字计算初传、中传、末传掌诀。
输入: 三个数字 (1-999) 输出: 三传掌诀符号及详细信息
2. three_passes_analysis - 三传关系分析
深度分析三传之间的关系。
输入: 三个掌诀索引 (0-8) 输出: 四维分析结果
- 五行流转分析
- 吉凶组合分析
- 阴阳平衡分析
- 发展趋势分析
MCP Prompts
1. divine_num - 数字占卜
使用三个数字进行完整占卜。
输入:
- 三个数字 (1-999)
- 占卜问题
输出: Markdown 格式的完整占卜解读
2. divine_words - 汉字占卜
使用三个汉字的笔画数进行占卜。
输入:
- 三个汉字
- 占卜问题
输出: 基于笔画数的占卜解读
3. divine_date - 日期占卜
使用农历日期进行占卜。
输入:
- 日期 (YYYY-MM-DD)
- 占卜问题
输出: 基于农历转换的占卜解读
Usage inside CC (Claude Code)
配置 MCP 服务器
在 Claude Code 中使用 XiaoLiuRenMCP，需要先配置 MCP 服务器：
- 创建项目级别 MCP 配置
- 在项目根目录创建 .mcp.json 文件 - 或使用命令: /mcp 进行配置
- 添加服务器配置
{
"mcpServers": {
"XiaoLiuRen_MCP": {
"command": "uv",
"args": [
"run",
"python",
"/path/to/XiaoLiuRenMCP/main.py"
],
"env": {
"LOG_LEVEL": "DEBUG",
"PYTHONPATH": "/path/to/XiaoLiuRenMCP"
}
}
}
}使用示例
1. 数字占卜
在 Claude Code 中使用 Slash Command 调用 MCP Prompt：
/XiaoLiuRen_MCP:divine_num (MCP)
参数:
- first_number: 8
- second_number: 15
- third_number: 23
- question: 我的事业发展如何？Claude Code 会：
- 调用 three_passes 工具计算三传
- 调用 three_passes_analysis 分析关系
- 生成完整的占卜解读
2. 汉字占卜
/XiaoLiuRen_MCP:divine_words (MCP)
参数:
- first_word: 天
- second_word: 地
- third_word: 人
- question: 我的感情运势如何？系统会自动计算笔画数：
- 天 = 4画
- 地 = 6画
- 人 = 2画
3. 日期占卜
/XiaoLiuRen_MCP:divine_date (MCP)
参数:
- date: 2024-01-01
- question: 明年运势如何？系统会自动转换为农历并进行占卜。
工作流程
- 选择 Prompt: 根据需求选择 divine_num、divine_words 或 divine_date
- 填写参数: 提供所需的输入参数
- 自动执行: Claude Code 自动调用相关工具
- 获得解读: 接收 Markdown 格式的完整占卜解读
高级用法
直接调用工具
如果只需要基础信息，可以使用 Slash Command 直接调用工具：
# 计算三传
/XiaoLiuRen_MCP:three_passes (MCP)
- first_number: 1
- second_number: 2
- third_number: 3
# 分析关系
/XiaoLiuRen_MCP:three_passes_analysis (MCP)
- initial_pass: 0
- middle_pass: 1
- final_pass: 2组合使用
可以组合使用多个工具和 Prompt：
1. 先用 /XiaoLiuRen_MCP:three_passes 获取掌诀
2. 再用 /XiaoLiuRen_MCP:three_passes_analysis 分析
3. 最后用 /XiaoLiuRen_MCP:divine_num 生成解读输出格式
所有 Prompt 都返回 Markdown 格式，包含：
# 小六壬占卜解读
## 占卜方式
[数字/汉字/日期]
## 您的问题
[用户问题]
## 三传掌诀
- 初传: [名称]（[含义]，[吉凶]）
- 中传: [名称]（[含义]，[吉凶]）
- 末传: [名称]（[含义]，[吉凶]）
## 三传关系分析
- 五行流转: [分析]
- 吉凶组合: [分析]
- 发展趋势: [分析]
- 综合评分: [分数]/100
## 针对您问题的解读
### 当前情况
[分析]
### 发展过程
[分析]
### 最终结果
[分析]
## 建议
[具体建议]项目结构
XiaoLiuRenMCP/
├── src/mcp_server/
│ ├── data/ # 数据层（掌诀、五行）
│ ├── rules/ # 规则层（特殊组合、五行规则）
│ ├── analysis/ # 分析层（四维分析）
│ ├── tools/ # MCP Tools
│ ├── utils/ # 工具函数（汉字、日期转换）
│ ├── prompts/ # MCP Prompts
│ └── server.py # MCP 服务器
├── tests/ # 测试文件（61个测试）
├── specs/ # PRD 文档
├── docs/ # 领域知识文档
└── main.py # 入口文件技术架构
核心组件
- 数据层 (142行)
- 九大掌诀数据 - 五行关系数据
- 规则层 (427行)
- 19 个精确组合规则 - 18 个五行流转规则 - 4 个阴阳平衡规则 - 动态规则引擎
- 分析层 (383行)
- 五行流转分析器 - 吉凶组合分析器 - 阴阳平衡分析器 - 发展趋势分析器
- 工具层 (223行)
- 汉字笔画数计算 - 公历/农历转换 - 数字验证和处理
规则引擎
优先级匹配:
- 精确组合匹配
- 五行流转模式匹配
- 阴阳平衡模式匹配
- 动态规则生成
覆盖率: 100% (729种组合)
测试
# 运行所有测试
uv run pytest
# 运行特定测试
uv run pytest tests/tools/
uv run pytest tests/prompts/
uv run pytest tests/analysis/
# 查看覆盖率
uv run pytest --cov=src/mcp_server测试统计:
- 总测试数: 61 个
- 通过率: 100%
- 覆盖率: 32.3%
版本历史
- v5.0.0 (2024-09) - 新增汉字和日期占卜方式
- v4.0.0 (2024-09) - 实现占卜解读 Prompt
- v3.0.0 (2024-09) - 实现三传关系分析工具
- v2.0.0 (2024-09) - 实现三传预测功能
- v1.0.0 (2024-09) - 基础 MCP 框架
贡献
欢迎贡献！请遵循以下步骤：
- Fork 项目
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启 Pull Request
开发规范
参考 CLAUDE.md 获取完整的开发规范和最佳实践。
许可证
MIT License - 详见 LICENSE 文件
致谢
- FastMCP - MCP 框架
- lunar_python - 农历转换
- strokes - 汉字笔画
联系方式
- GitHub: @aicoder2048
- 项目链接:
注意: 占卜结果仅供参考和娱乐，不应作为决策依据。人的命运掌握在自己手中，积极行动比消极等待更重要。