小六壬 MCP (XiaoLiuRen Model Context Protocol)

Install with NPX in VS Code

一个基于 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(时辰序号) → 空亡 🔮 占卜结果：【空亡】 - 五行属性：土 - 吉凶性质：凶 - 基本含义：空、亡，事情落空不成，但也有无事之意。性质特殊，倾向虚无。 - 详细解释：空亡有两种可能：一是大凶结果很差，二是什么都不会发生。问失物为未丢，问寻找为找不到。常代表弃考、放弃等情况。 💡 建议指导： 🌫️ 情况比较特殊，可能有两种截然不同的结果。 • 可能性一：事情完全落空，什么都不会发生 • 可能性二：结果很差，遭遇较大失败 • 特殊含义：在某些情况下反而表示"没有问题" • 心理状态：可能已经有放弃的念头 • 总体建议：重新审视目标，或许应该转换思路和方向

六神体系

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

六神	五行	性质	基本含义	详细象意
大安	木	吉	安稳安逸美事，但也有静止之意	事情平稳发展，宜守不宜动。感情平稳但可能平淡，财运稳定。适合问成功类问题。
留连	土	凶	反复、犹豫、拖延、纠缠、暧昧	纯阴卦，主不光明、秘密。事情未定仍有变化，夜晚测得尤为不稳定。
速喜	火	吉	火热、快速、好事，不长久	短期事情大吉，长期后劲不足。为朱雀，有口舌争辩之象。需快速行动。
赤口	金	凶	口舌官非、凶险意外	为白虎，代表挫败。落此宫必定失败，也主精神紧张。有交谈合作等正面象意。
小吉	水	平	驿马宫，向好发展但需努力	纯阳卦，变化可能性最大。成功取决于个人努力，积极则吉，消极则平。
空亡	土	凶	空亡，落空不成，虚无	两种可能：大凶或无事发生。问失物为未丢，问寻找为找不到。常代表放弃。

算法说明

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

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

开发指南

技术栈

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

XiaoLiuRen MCP Server