小六壬 MCP (XiaoLiuRen Model Context Protocol)

一个基于 Model Context Protocol (MCP) 的小六壬占卜分析服务器，提供传统的六神占卜功能。

小六壬出自《增补许真君万全玉匣记》，名为“李淳风六壬时课”，是一种古代靠“掐指”来占卜的方法，源于六曜历注和六轮兀法（《居家必用事类全集·六轮经兀法》）。

占时将“大安、留连、速喜、赤口、小吉、空亡”分置食指、中指、无名指上，以“月、日、时”轮指数出，得大安、速喜、小吉为吉，其余为凶。明清时期的白话小说有其踪迹，如《醒世姻缘传》：“街上一个打路庄板的瞎子走过。相大舅叫他进来，与狄希陈起课，说是速喜，时下就到”，《隋唐演义》：“叔宝便说个申时。妇人捻指一算，便道：卦名速喜”。

其“大安、留连、速喜、赤口、小吉、空亡”和六壬式十二天将的六神“青龙、玄武、朱雀、白虎、六合、勾陈”对应，可能是称为六壬时课或小六壬的原因。

—— 维基百科

功能介绍

• 🗓️ 精准农历转换：支持阳历转农历，提供准确的干支纪年信息
• 🕐 时辰计算：自动识别传统十二时辰
• 🔮 小六壬占卜：基于传统算法的六神推算
• � 智能解读：提供详细的占卜解释和行动建议

使用方法

安装依赖

npm install

启动服务

node index.js

工具调用

服务器提供 analyze_xiaoliuren 工具：

参数：

• date: 日期（格式：YYYY-MM-DD）
• time: 时间（格式：HH:MM）
• calendar_type: 历法类型（"solar" = 阳历，"lunar" = 农历）

调用示例：

{
  "name": "analyze_xiaoliuren",
  "arguments": {
    "date": "2025-09-25",
    "time": "14:30", 
    "calendar_type": "solar"
  }
}

输出示例

小六壬占卜结果：

🗓️ 输入信息：
- 原始日期：2025-09-25（阳历）
- 时辰：14:30 (未时)

📅 农历信息：
- 农历日期：2025年八月初四
- 年干支：乙巳
- 月干支：乙酉
- 日干支：丁酉
- 时辰：未时

🧮 小六壬推算过程：
- 农历8月 → 留连
- 从留连数4日 → 小吉
- 从小吉数8(时辰序号) → 空亡

🔮 占卜结果：【空亡】
- 五行属性：土
- 吉凶性质：凶
- 基本含义：空、亡，事情落空不成，但也有无事之意。性质特殊，倾向虚无。
- 详细解释：空亡有两种可能：一是大凶结果很差，二是什么都不会发生。问失物为未丢，问寻找为找不到。常代表弃考、放弃等情况。

💡 建议指导：
🌫️ 情况比较特殊，可能有两种截然不同的结果。
• 可能性一：事情完全落空，什么都不会发生
• 可能性二：结果很差，遭遇较大失败  
• 特殊含义：在某些情况下反而表示"没有问题"
• 心理状态：可能已经有放弃的念头
• 总体建议：重新审视目标，或许应该转换思路和方向

六神体系

小六壬包含六个神煞，各有特定含义和象意：

算法说明

小六壬推算采用传统三步法：

1. 月将推算：根据农历月份确定起始位置
2. 日期推算：从月将位置按农历日期继续数算
3. 时辰推算：从日期位置按时辰序号最终定位

开发指南

技术栈

• Node.js - 运行时环境
• @modelcontextprotocol/sdk - MCP 框架
• js-calendar-converter - 农历转换库

VS Code 开发

项目已配置好 VS Code 开发环境：

快速启动

• 按 F5 启动调试模式
• 或选择 启动小六壬MCP服务器 配置启动

可用的启动配置

• 启动小六壬MCP服务器 - 普通启动模式
• 调试小六壬MCP服务器 - 调试模式（可设置断点）

可用的任务

• Ctrl+Shift+P → Tasks: Run Task 选择：
  • 启动MCP服务器 - 普通启动
  • watch模式启动MCP服务器 - 文件变化自动重启（后台运行）
  • 测试MCP服务器 - 快速连接测试

开发脚本

npm run dev        # watch模式启动
npm run debug      # 调试模式启动  
npm run vscode-test # VS Code集成测试

项目结构

├── .vscode/           # VS Code配置文件
│   ├── launch.json    # F5启动配置
│   ├── tasks.json     # 任务配置
│   └── settings.json  # 工作区设置
├── index.js           # 主服务器文件
├── mcp-config.json    # MCP客户端配置示例
├── vscode-test.js     # VS Code测试脚本
├── package.json       # 项目配置
└── README.md         # 说明文档

MCP 客户端集成

使用 mcp-config.json 配置文件可以将此服务器集成到支持MCP的客户端（如Claude Desktop）中：

{
  "mcpServers": {
    "小六壬": {
			"type": "stdio",
			"command": "npx",
			"args": [
				"-y",
				"xiaoliuren-mcp"
			]
		}
  }
}

核心模块

• calculateXiaoLiuRen() - 小六壬核心算法
• getShichen() - 时辰计算
• getAdvice() - 建议生成

扩展开发

如需扩展功能，可以：

• 修改六神定义和解释内容
• 添加更多占卜方法
• 增强输出格式
• 集成其他传统算法

许可证

MIT License