Lunar Calendar Service(万年历)

MCP办公协作

提供方 wouhao

办公协作 HTTP · 远程 会话登录 社区 / 第三方 Claude DesktopClaudeCursorWindsurf
查看接入方式

中文万年历 MCP 服务。支持公农历转换、二十四节气、法定节假日、黄历宜忌、八字五行、黄道吉日查询,共 9 个工具,直接接入 Claude/Cursor 使用。

一句话选型结论

按资料字段整理

Lunar Calendar Service(万年历) 属于办公协作类 MCP 服务器,HTTP · 远程,会话登录,可直接接入 Claude Desktop、Claude、Cursor 等,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类办公协作 传输方式HTTP · 远程 鉴权会话登录 部署方式远程部署
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

办公协作
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

calendar chinese

支持客户端

适用场景

calendarchinese

安装与配置

HTTP · 远程 会话登录
连远程 HTTPS 端点,通常为 Streamable HTTP
https://cheerful-trust-production-065e.up.railway.app/sse

把它填进客户端的 MCP 配置即可,不需要在本地安装运行时。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
日程与消息

查日程、发消息、约会议。

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在办公协作场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Lunar Calendar Service(万年历)当前 未标注 HTTP · 远程 远程部署 有 未标注
CowAgent 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Karakeep MCP 未标注 未标注 未标注 无 2026-05-17
agentscope 未标注 stdio · 本地进程 本地部署 有 2026-04-11
note-gen 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Everywhere 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

办公协作
字段来自项目仓库与公开索引,中文说明由本站标注
提供方wouhao上游标注的维护方 wouhao
分类办公协作本站按上游分类展示
连接方式HTTP · 远程连远程 HTTPS 端点,通常为 Streamable HTTP
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Cross-platform本地安装时用到的包标识与运行时
部署类型远程部署上游给出的部署形态
最近核验未标注上游最后核验时间

详细介绍

3.5 KB
来自项目仓库与上游目录的原文,未做删改

lunar-calendar-service

> 🗓️ 给 AI Agent 使用的中文万年历 MCP 服务。提供公农历转换、二十四节气、法定节假日、黄历宜忌、八字五行等查询能力。

线上服务: https://cheerful-trust-production-065e.up.railway.app/sse


快速接入

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:```json
{
"mcpServers": {
"lunar-calendar": {
"url": "https://cheerful-trust-production-065e.up.railway.app/sse",
"transport": "sse"
}
}
}


### Cursor / Windsurf

在 MCP 设置里添加:```
Name: lunar-calendar
URL:  https://cheerful-trust-production-065e.up.railway.app/sse
Type: SSE

本地运行(stdio 模式)```bash

git clone https://github.com/wouhao/lunar-calendar-service
cd lunar-calendar-service
uv sync

Claude Desktop 本地接入

claude_desktop_config.json:

{

"mcpServers": {

"lunar-calendar": {

"command": "uv",

"args": ["run", "python", "server.py"],

"cwd": "/path/to/lunar-calendar-service"

}

}

}

uv run python server.py


---

## 可用工具(9 个)

### 基础功能

| 工具 | 参数 | 说明 |
|------|------|------|
| `get_date_info` | `date: YYYY-MM-DD` | 返回公历/农历/干支/生肖/星座/节气/节假日完整信息 |
| `solar_to_lunar` | `date: YYYY-MM-DD` | 公历 → 农历 |
| `lunar_to_solar` | `year, month, day, leap_month?` | 农历 → 公历(支持闰月) |
| `get_solar_terms` | `year: int` | 查询某年全部 24 节气日期 |
| `is_holiday` | `date: YYYY-MM-DD` | 是否节假日 / 调休上班 |
| `get_holidays` | `year: int` | 某年全部法定节假日列表 |

### 黄历

| 工具 | 参数 | 说明 |
|------|------|------|
| `get_almanac` | `date: YYYY-MM-DD` | 每日宜忌、吉神方位(喜/福/财)、纳音、彭祖百忌 |

### 高级

| 工具 | 参数 | 说明 |
|------|------|------|
| `get_advanced_info` | `date: YYYY-MM-DD, hour?: 0-23` | 八字、五行、星宿、胎神、佛历、道历、黄道黑道 |
| `get_lucky_days` | `start_date, end_date, purpose?` | 查询范围内的黄道吉日,可指定用途 |

---

## 使用示例

接入后,你可以这样问 Claude:

- "今天是什么日子?有没有节气?"
- "明天黄历上宜什么忌什么?"
- "2025 年春节是哪天?"
- "下个月有哪些黄道吉日适合开业?"
- "帮我查一下 2025 年全年节假日安排"
- "农历正月初一是公历几号?"

---

## 技术栈

| 层次 | 技术 |
|------|------|
| 语言 | Python 3.11+ |
| 包管理 | uv |
| 底层历法库 | lunar-python 1.4.8 |
| 服务层 | FastMCP (MCP SDK) |
| Schema | Pydantic v2 |
| 节假日数据 | 静态 JSON(2025 年) |
| 部署 | Railway |

---

## 本地开发```bash
# 安装依赖
uv sync

# 运行测试
uv run pytest tests/ -v

# CLI 快捷查询
uv run python cli.py today

# 本地 HTTP/SSE 模式
MCP_TRANSPORT=sse PORT=8000 uv run python server.py
curl http://localhost:8000/health

自行部署到 Railway

项目已包含 railway.json 和 Procfile:

  1. Fork 本仓库
  2. 在 Railway 创建项目,导入 GitHub 仓库
  3. 部署完成后,MCP endpoint 为 https://.up.railway.app/sse

路线图

  • [x] Phase 1:核心功能(公农历/节气/节假日)
  • [x] Phase 2:黄历增强(宜忌/方位/纳音)
  • [x] Phase 3:高级功能(八字/五行/吉日)
  • [x] Phase 4:Railway 云端部署
  • [ ] 补充 2026 年节假日数据
  • [ ] 更多年份节假日支持

License

MIT


> 如有问题或建议,欢迎提 Issue 或 PR。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Lunar Calendar Service(万年历) 怎么安装?

在客户端按下面的安装命令接入:https://cheerful-trust-production-065e.up.railway.app/sse。装完在客户端配置里引用同一个包或端点。

Lunar Calendar Service(万年历) 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是HTTP · 远程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Lunar Calendar Service(万年历) 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Lunar Calendar Service(万年历) 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Lunar Calendar Service(万年历) 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、Windsurf、Codex、Zed;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Lunar Calendar Service(万年历) 能提供哪些能力?

资料显示能力标签包括 calendar、chinese。具体工具清单以官方文档为准。

Lunar Calendar Service(万年历) 需要什么运行环境?

运行时为 Cross-platform;属于远程端点,不需要在本地装运行时。

Lunar Calendar Service(万年历) 是本地还是远程?

它是远程端点,连服务地址即可。传输方式为HTTP · 远程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 未标注。