---
title: luner_info1
canonical_url: "https://www.modelscope.cn/studios/momomy/luner_info1"
md_url: "https://www.modelscope.cn/studios/momomy/luner_info1.md"
repository: momomy/luner_info1
last_updated: 2025-07-07
sdk_type: gradio
sdk_version: 5.29.0
downloads: 0
stars: 0
---

# luner_info1

> luner_info1 - momomy 在 ModelScope 创建的在线 Demo。一个基于传统中华黄历的智能查询应用，支持MCP服务器和Gradio Web界面，可在魔搭（ModelScope）平台上部署。

momomy/luner_info1 是 ModelScope 魔搭社区上的在线可交互 Demo（创空间），基于 gradio 5.29.0 构建。

- **Repository**: momomy/luner_info1
- **SDK**: gradio
- **SDK version**: 5.29.0
- **Downloads**: 0
- **Stars**: 0
- **Last updated**: 2025-07-07

Source: https://www.modelscope.cn/studios/momomy/luner_info1

---

# 🏮 中华黄历查询应用

一个基于传统中华黄历的智能查询应用，支持MCP服务器和Gradio Web界面，可在魔搭（ModelScope）平台上部署。

## ✨ 功能特色

### 📅 完整黄历信息
- 公历与农历日期对照
- 干支纪年、纪日系统
- 生肖年份查询
- 五行属性分析
- 二十八宿星座

### 🎯 运势分析
- 每日总体运势评级
- 详细运势解读
- 七级吉凶等级（大吉、中吉、小吉、平、小凶、中凶、大凶）

### ⏰ 时辰吉凶
- 十二时辰详细分析
- 每个时辰的吉凶等级
- 最佳行事时间推荐

### 📋 宜忌事项
- 每日适宜事项推荐
- 忌讳事项提醒
- 涵盖生活各个方面

### 🤖 智能问答
- 自然语言交互
- 智能理解用户意图
- 个性化黄历咨询

## 🚀 快速开始

### 本地运行

1. **安装依赖**
```bash
pip install -r requirements.txt
```

2. **启动Gradio应用**
```bash
python app.py
```

3. **启动MCP服务器**
```bash
python huangli_mcp_server.py
```

### 魔搭平台部署

1. **上传文件**
   - 将所有文件上传到魔搭平台
   - 确保`app.py`作为主入口文件

2. **配置环境**
   - 平台会自动安装`requirements.txt`中的依赖
   - 默认端口为7860

3. **启动应用**
   - 平台会自动执行`app.py`
   - 应用将在指定端口启动

## 📁 文件结构

```
.
├── app.py                      # 魔搭平台入口文件
├── huangli_modelscope_app.py    # Gradio应用主文件
├── huangli_mcp_server.py        # MCP服务器文件
├── requirements.txt             # 依赖配置文件
└── README.md                   # 说明文档
```

## 🔧 技术架构

### 核心组件

1. **HuangLiCore类**
   - 黄历核心算法实现
   - 干支、生肖、五行计算
   - 运势生成逻辑

2. **MCP服务器**
   - 基于Model Context Protocol
   - 提供标准化API接口
   - 支持工具调用和资源查询

3. **Gradio界面**
   - 现代化Web界面
   - 响应式设计
   - 多标签页布局

### 算法说明

- **干支计算**: 基于1984年甲子年的偏移量计算
- **生肖推算**: 十二生肖循环系统
- **农历转换**: 简化的农历日期计算
- **运势生成**: 基于日期种子的伪随机算法
- **时辰分析**: 十二时辰与现代时间对照

## 🎨 界面预览

### 黄历查询页面
- 日期选择器
- 快捷按钮（今日/明日/昨日）
- 详细黄历信息展示
- 美观的Markdown格式

### AI助手页面
- 智能聊天界面
- 自然语言问答
- 历史对话记录
- 实时响应

## 🔌 MCP服务器API

### 可用工具

1. **query_huangli**
   - 查询指定日期的完整黄历信息
   - 参数: `date` (可选，格式: YYYY-MM-DD)

2. **get_fortune**
   - 获取指定日期的运势信息
   - 参数: `date` (可选，格式: YYYY-MM-DD)

3. **get_shichen**
   - 获取指定日期的时辰吉凶信息
   - 参数: `date` (可选，格式: YYYY-MM-DD)

4. **get_yi_ji**
   - 获取指定日期的宜忌事项
   - 参数: `date` (可选，格式: YYYY-MM-DD)

### 可用资源

1. **huangli://today**
   - 今日完整黄历信息
   - 返回JSON格式数据

2. **huangli://calendar**
   - 黄历日历查询接口说明
   - 工具使用指南

## 🌟 使用示例

### Gradio界面使用

1. **查询今日黄历**
   - 点击"今日"按钮
   - 查看完整黄历信息

2. **查询特定日期**
   - 输入日期格式: 2024-01-01
   - 点击"查询黄历"按钮

3. **AI助手对话**
   - 输入: "今天运势如何？"
   - 输入: "明天适合做什么？"
   - 输入: "今日时辰吉凶"

### MCP服务器调用

```python
# 查询今日黄历
result = await server.call_tool("query_huangli", {})

# 查询指定日期
result = await server.call_tool("query_huangli", {"date": "2024-01-01"})

# 获取运势信息
result = await server.call_tool("get_fortune", {"date": "2024-01-01"})
```

## ⚙️ 配置说明

### 环境变量

- `PORT`: 服务端口（默认: 7860）
- `HOST`: 服务主机（默认: 0.0.0.0）

### 自定义配置

可以修改`HuangLiCore`类中的以下配置：
- 宜忌事项列表
- 运势等级定义
- 时辰名称和时间范围
- 五行和星宿数据

## 🔍 故障排除

### 常见问题

1. **依赖安装失败**
   - 检查Python版本（推荐3.8+）
   - 使用国内镜像源安装

2. **端口占用**
   - 修改环境变量PORT
   - 检查防火墙设置

3. **MCP服务器连接失败**
   - 检查stdio输入输出
   - 验证MCP协议版本

### 调试模式

启用详细日志输出：
```python
import logging
logging.basicConfig(level=logging.DEBUG)
```

## 📄 许可证

本项目采用MIT许可证，详见LICENSE文件。

## 🤝 贡献指南

欢迎提交Issue和Pull Request来改进这个项目！

### 开发环境设置

1. Fork本仓库
2. 创建功能分支
3. 提交更改
4. 创建Pull Request

## 📞 联系方式

如有问题或建议，请通过以下方式联系：
- 提交GitHub Issue
- 发送邮件反馈

## 🙏 致谢

感谢所有为中华传统文化传承做出贡献的开发者和用户！

---

**注意**: 本应用基于传统黄历算法实现，仅供参考娱乐使用，请理性对待黄历信息。