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).

Related MCP server: Chinese Fortune Analysis System (BaZi)

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 protocol

Trigger 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.