lunar-mcp — Chinese lunar calendar + BaZi MCP server
An MCP server for lunar calendar operations and BaZi calculations. Solar↔lunar conversion, auspicious day guidance, 24 Solar Terms, Five Elements analysis — all accessible to any MCP-compatible agent.
Overview
lunar-mcp is a Model Context Protocol server that exposes Chinese lunar calendar and BaZi (Four Pillars) tools to AI agents. It handles solar-to-lunar and lunar-to-solar date conversion, generates Huang Li (auspicious day) guidance, calculates BaZi charts, tracks the 24 Solar Terms (節氣), and analyzes Five Elements composition. Based on AlbertHuangKSFO/lunar_mcp_server (MIT).
Features
- BaZi calculation — Four Pillars from birth date
- Date conversion — solar ↔ lunar calendar
- Huang Li — auspicious and inauspicious day guidance
- Daily fortune — daily luck overview
- 24 Solar Terms — 節氣 tracking
- Five Elements — Ngũ Hành composition analysis
- MCP protocol — works with any MCP-compatible agent
Usage / Quick Start
pip install lunar-python
# then connect via MCP protocolTrigger Keywords (OpenClaw)
lịch âm, âm lịch, lunar calendar, hoàng lịch, tiết khí, solar terms, ngũ hành, five elements, bazi calculation, 农历, 黄历
Related Skills
- destiny-engine — full BaZi + Western astrology analysis
--- Part of the NachaFromMars OpenClaw skill ecosystem.
