A
securityA
licenseA
qualityA Model Context Protocol plugin for Chinese Tung Shing (黄历/通勝/通胜) almanac calculations
Last updated -
1
12
33
MIT License
六壬MCP服务器
基于kentang2017/kinliuren项目实现的六壬排盘MCP服务器。
参考MCPQimenJson项目重构，采用简洁的架构和标准的MCP协议。
功能特点
✅ 标准的MCP (Model Context Protocol) 服务器
✅ 支持JSON-RPC 2.0协议通信
✅ 提供六壬排盘计算工具
✅ 提供当前时间获取工具
✅ 直接调用kinliuren库，输出原始结果
✅ 简洁的架构，无复杂封装层
安装依赖
pip install -r requirements.txt
MCP工具说明
1. get_current_time
获取当前系统时间，返回详细的时间信息。
输入参数: 无
输出: 当前时间的详细JSON信息
2. calculate_liuren
计算指定时间的六壬排盘，返回完整的六壬数据。
输入参数:
datetime_str: 时间字符串，格式YYYY-MM-DD HH:MM:SS
输出: 包含六壬排盘完整数据的JSON结果
作为MCP服务器使用
该工具设计为MCP服务器，通过标准输入输出进行JSON-RPC通信：
// 初始化请求
{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {}}
// 工具列表请求
{"jsonrpc": "2.0", "id": 2, "method": "tools/list", "params": {}}
// 工具调用请求
{"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": {
"name": "calculate_liuren",
"arguments": {"datetime_str": "2024-01-15 14:30:00"}
}}
输出格式
六壬排盘结果
工具返回完整的六壬排盘JSON数据：
{
"success": true,
"data": {
"year": 2024,
"month": 1,
"day": 15,
"hour": 14,
"minute": 30,
"solar_term": "小寒",
"lunar_month": "腊",
"day_ganzhi": "癸丑",
"hour_ganzhi": "庚申",
"liuren_data": {
"格局": ["比用", "知一"],
"日馬": "寅",
"三傳": {
"初傳": ["戌", "合", "財", "丙"],
"中傳": ["巳", "陰", "子", "癸"],
"末傳": ["子", "龍", "父", "戊"]
},
"四課": {
"四課": ["戌卯", "合"],
"三課": ["卯申", "常"],
"二課": ["辰酉", "玄"],
"一課": ["酉甲", "雀"]
},
"天地盤": {
"天盤": ["午", "未", "申", "酉", "戌", "亥", "子", "丑", "寅", "卯", "辰", "巳"],
"地盤": ["亥", "子", "丑", "寅", "卯", "辰", "巳", "午", "未", "申", "酉", "戌"],
"天將": ["后", "貴", "蛇", "雀", "合", "勾", "龍", "空", "虎", "常", "玄", "陰"]
}
// ... 更多六壬数据
}
}
}
时间获取结果
{
"success": true,
"data": {
"year": 2024,
"month": 1,
"day": 15,
"hour": 14,
"minute": 30,
"second": 45,
"datetime_str": "2024-01-15 14:30:45",
"weekday": "Monday",
"weekday_cn": "星期一",
"timestamp": 1705323045
}
}
项目结构
MCPliuren/
├── liuren_mcp.py # 主要的六壬MCP服务器
├── config.py # 配置文件和辅助函数
├── requirements.txt # 项目依赖
└── README.md # 说明文档
依赖库
kinliuren: 六壬排盘计算库
sxtwl: 中国传统天文历法计算库
技术实现
MCP协议支持: 实现完整的JSON-RPC 2.0协议
简洁架构: 直接调用kinliuren库，无复杂封装
配置分离: 使用独立的config.py处理配置逻辑
错误处理: 完善的异常处理和错误响应
标准化输出: 返回结构化的JSON结果
MCP协议特性
initialize: 服务器初始化
tools/list: 获取可用工具列表
tools/call: 调用具体工具
错误处理: 标准JSON-RPC错误响应
注意事项
确保Python版本>=3.6
需要网络连接来安装依赖包
时间计算基于中国传统历法
作为MCP服务器使用时，通过标准输入输出进行通信
This server cannot be installed
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityAn AI-powered metaphysical Bazi calculator that provides accurate Chinese astrological chart calculations for personality analysis and destiny forecasting, addressing inaccuracies in existing AI fortune-telling tools.Last updated -225145202ISC License
- -securityAlicense-qualityIntegrates I Ching divination with AI responses, allowing users to receive guidance through traditional Chinese philosophy using the bibliomantic approach described in Philip K. Dick's work.Last updated -1MIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that provides accurate Chinese Ziwei Doushu astrology chart calculations and horoscope analysis, enabling AI assistants to generate personalized astrological readings through natural language queries.Last updated -32MIT License